diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 000000000..e36a23487 --- /dev/null +++ b/.github/CODEOWNERS @@ -0,0 +1,21 @@ +# Code owners for graphify. +# +# Owners are automatically requested for review on pull requests that touch +# matching paths. This file is advisory review routing; it does not by itself +# block merges unless "Require review from Code Owners" is enabled in branch +# protection. +# +# See: https://docs.github.com/articles/about-code-owners + +# Default owner for everything in the repo. +* @safishamsi + +# Skill generation is roundtrip-sensitive (monolith sanctioned diffs); flag it. +/tools/skillgen/ @safishamsi +/graphify/skill*.md @safishamsi +/graphify/skills/ @safishamsi + +# Release, security, and CI configuration. +/.github/workflows/ @safishamsi +/SECURITY.md @safishamsi +/RELEASING.md @safishamsi diff --git a/.github/DISCUSSION_TEMPLATE/q-a.yml b/.github/DISCUSSION_TEMPLATE/q-a.yml new file mode 100644 index 000000000..e8ed1fd9c --- /dev/null +++ b/.github/DISCUSSION_TEMPLATE/q-a.yml @@ -0,0 +1,34 @@ +labels: [] +body: + - type: markdown + attributes: + value: | + Thanks for asking. Before posting, please check the + [docs](https://docs.graphify.com) and search existing + [discussions](https://github.com/Graphify-Labs/graphify/discussions) + and [issues](https://github.com/Graphify-Labs/graphify/issues) — your + question may already be answered. For real-time help, join the + [Discord](https://discord.gg/XDnKVpzdXB). If you have found a bug, please + open an issue instead so it can be tracked. + - type: textarea + id: question + attributes: + label: What are you trying to do? + description: Describe the goal and the question, not only the error. + validations: + required: true + - type: textarea + id: tried + attributes: + label: What have you tried? + description: Commands you ran, docs you read, and what happened. + validations: + required: false + - type: input + id: version + attributes: + label: graphify version and environment + description: Output of `graphify --version`, plus your OS and Python version. + placeholder: "graphify 0.9.70, macOS 15, Python 3.12" + validations: + required: false diff --git a/SUPPORT.md b/SUPPORT.md new file mode 100644 index 000000000..0d89172f8 --- /dev/null +++ b/SUPPORT.md @@ -0,0 +1,32 @@ +# Getting help with graphify + +Thanks for using graphify. Here is where to go, depending on what you need. + +## Questions, ideas, and usage help + +- **Docs:** [docs.graphify.com](https://docs.graphify.com) — guides, command reference, and integrations. Start here. +- **GitHub Discussions:** [Discussions](https://github.com/Graphify-Labs/graphify/discussions) for longer-form questions, ideas, and show-and-tell. +- **Discord:** [discord.gg/XDnKVpzdXB](https://discord.gg/XDnKVpzdXB) for real-time chat with the community and maintainers. + +Please search the docs and existing discussions/issues before posting — your question may already be answered. + +## Bug reports + +Open a [bug report](https://github.com/Graphify-Labs/graphify/issues/new/choose). To help us reproduce it quickly, include: + +- what you expected and what actually happened, +- the smallest input that reproduces it (a sample file or repo helps a lot), +- the relevant cache entry from `graphify-out/cache/` for an extraction bug, +- your OS, Python version, and `graphify --version`. + +## Feature requests + +Open a [feature request](https://github.com/Graphify-Labs/graphify/issues/new/choose) describing the problem you are trying to solve, not only the solution you have in mind. + +## Security vulnerabilities + +Do **not** open a public issue. Report privately via the [security policy](https://github.com/Graphify-Labs/graphify/security/policy). See [SECURITY.md](SECURITY.md). + +## Contributing + +Want to help? See [CONTRIBUTING.md](CONTRIBUTING.md). Worked examples and extraction bug reports are the most useful contributions.