GraphCompose is a solo-maintained open-source library. This file describes where to go for what.
| Need | Where |
|---|---|
| Usage question | GitHub Discussions — not the issue tracker |
| Bug report | Bug report template |
| Feature request | Feature request template |
| Security vulnerability | SECURITY.md — do not use public issues |
| Documentation gap | Open an issue with the docs label, or a PR against the affected file |
Self-serve, ordered by likelihood of containing the answer:
- README.md — installation, hello-world, which artifact to depend on.
- docs/first-document.md — the five-minute path to a rendered PDF.
- docs/getting-started.md — DSL or templates, and the first-render walk-through.
- examples/README.md — runnable examples with PDF previews.
- docs/recipes.md — patterns for common layouts.
- docs/troubleshooting.md — symptom-first fixes for the common gotchas.
- docs/architecture/overview.md and docs/architecture/package-map.md — when extending the engine.
- docs/migration/v2.0.0-modules.md — upgrading from the 1.x line; CHANGELOG.md for minor-to-minor steps.
Best-effort. Triage typically within a week. Reports with minimal reproductions get priority. There is no paid support tier.
- Hosted PDF rendering service. GraphCompose is a library; deploy it inside your application.
- Commercial integration support. Issues are public and best-effort.
- Modifications to third-party dependencies (PDFBox, Apache POI, etc.). Report those upstream.
- Correctness of generated content. The DSL renders what you describe — sanitising user-supplied data is the caller's responsibility.
If you want to contribute rather than ask for help, see CONTRIBUTING.md. Lane structure and architecture rules: docs/architecture/overview.md.