Skip to content

docs: add CI automation guide and issue triage reference#779

Merged
aldbr merged 1 commit intoDIRACGrid:mainfrom
chrisburr:docs/contributing-guides
Mar 27, 2026
Merged

docs: add CI automation guide and issue triage reference#779
aldbr merged 1 commit intoDIRACGrid:mainfrom
chrisburr:docs/contributing-guides

Conversation

@chrisburr
Copy link
Copy Markdown
Member

Summary

  • Add a "CI Automation" section to docs/dev/how-to/contribute.md explaining:
    • Automatic draft conversion when a reviewer requests changes
    • Daily PR review reminder digest on Mattermost
  • Create new docs/dev/reference/issue-triage.md page with project management content moved from DIRACGrid/.github CONTRIBUTING.md:
    • Issue workflow states (Idea → Triage → Design → Sprint → Done) with mermaid diagram
    • GitHub Projects fields (area, priority, type, story points, sprint)
    • Issue creation guidelines for bug reports and feature requests
  • Add the new page to the mkdocs nav under Developer Guide > Reference

@read-the-docs-community
Copy link
Copy Markdown

read-the-docs-community bot commented Feb 9, 2026

Documentation build overview

📚 diracx | 🛠️ Build #32007652 | 📁 Comparing 9701a71 against latest (07c549d)


🔍 Preview build

Show files changed (120 files in total): 📝 119 modified | ➕ 1 added | ➖ 0 deleted
File Status
404.html 📝 modified
index.html 📝 modified
REFERENCE/index.html 📝 modified
RUN_PROD/index.html 📝 modified
SECURITY/index.html 📝 modified
SSO/index.html 📝 modified
admin/index.html 📝 modified
dev/index.html 📝 modified
developers/index.html 📝 modified
roadmap/index.html 📝 modified
user/index.html 📝 modified
admin/explanations/index.html 📝 modified
admin/how-to/index.html 📝 modified
admin/reference/index.html 📝 modified
admin/tutorials/index.html 📝 modified
dev/explanations/index.html 📝 modified
dev/how-to/index.html 📝 modified
dev/reference/index.html 📝 modified
dev/tutorials/index.html 📝 modified
user/explanations/index.html 📝 modified
user/how-to/index.html 📝 modified
user/reference/index.html 📝 modified
user/tutorials/index.html 📝 modified
admin/explanations/auth-with-diracx/index.html 📝 modified
admin/explanations/auth-with-external/index.html 📝 modified
admin/explanations/chart-structure/index.html 📝 modified
admin/explanations/configuration/index.html 📝 modified
admin/explanations/database-management/index.html 📝 modified
admin/explanations/manage-web-release/index.html 📝 modified
admin/explanations/opentelemetry/index.html 📝 modified
admin/explanations/sandbox-store/index.html 📝 modified
admin/explanations/user-management/index.html 📝 modified
admin/how-to/debugging/index.html 📝 modified
admin/how-to/install/index.html 📝 modified
admin/how-to/rotate-a-secret/index.html 📝 modified
admin/how-to/upgrading/index.html 📝 modified
admin/reference/env-variables/index.html 📝 modified
admin/reference/security_model/index.html 📝 modified
admin/reference/settings-and-preferences/index.html 📝 modified
admin/reference/values/index.html 📝 modified
admin/tutorials/authentication/index.html 📝 modified
admin/tutorials/run_locally/index.html 📝 modified
dev/explanations/components/index.html 📝 modified
dev/explanations/dependency-management/index.html 📝 modified
dev/explanations/designing-functionality/index.html 📝 modified
dev/explanations/documentation-system/index.html 📝 modified
dev/explanations/extensions/index.html 📝 modified
dev/explanations/job_commands/index.html 📝 modified
dev/explanations/repo-structure/index.html 📝 modified
dev/explanations/run_demo/index.html 📝 modified
dev/explanations/testing/index.html 📝 modified
dev/explanations/web-architecture/index.html 📝 modified
dev/explanations/web-testing/index.html 📝 modified
dev/how-to/add-a-cli-command/index.html 📝 modified
dev/how-to/add-a-db/index.html 📝 modified
dev/how-to/add-a-route/index.html 📝 modified
dev/how-to/add-a-setting/index.html 📝 modified
dev/how-to/add-a-task/index.html 📝 modified
dev/how-to/add-a-test/index.html 📝 modified
dev/how-to/add-functionality/index.html 📝 modified
dev/how-to/client-customization/index.html 📝 modified
dev/how-to/client-extension/index.html 📝 modified
dev/how-to/client-generation/index.html 📝 modified
dev/how-to/contribute/index.html 📝 modified
dev/how-to/contribute-to-web/index.html 📝 modified
dev/how-to/create-web-application/index.html 📝 modified
dev/how-to/develop-legacy-dirac/index.html 📝 modified
dev/how-to/extend-diracx/index.html 📝 modified
dev/how-to/manage-web-extension/index.html 📝 modified
dev/how-to/setup-web-environment/index.html 📝 modified
dev/how-to/use-the-demo/index.html 📝 modified
dev/how-to/write-docs/index.html 📝 modified
dev/reference/application-state/index.html 📝 modified
dev/reference/client-metapathfinder/index.html 📝 modified
dev/reference/coding-conventions/index.html 📝 modified
dev/reference/configuration/index.html 📝 modified
dev/reference/db-transaction-model/index.html 📝 modified
dev/reference/dependency-injection/index.html 📝 modified
dev/reference/entrypoints/index.html 📝 modified
dev/reference/env-variables/index.html 📝 modified
dev/reference/issue-triage/index.html ➕ added
dev/reference/pixi-tasks/index.html 📝 modified
dev/reference/security-policies/index.html 📝 modified
dev/reference/security-properties/index.html 📝 modified
dev/reference/test-recipes/index.html 📝 modified
dev/reference/web-coding-conventions/index.html 📝 modified
dev/reference/writing-tests/index.html 📝 modified
dev/tutorials/advanced-tutorial/index.html 📝 modified
dev/tutorials/getting-started/index.html 📝 modified
dev/tutorials/larger-developments/index.html 📝 modified
dev/tutorials/making-changes/index.html 📝 modified
dev/tutorials/play-with-auth/index.html 📝 modified
dev/tutorials/run-locally/index.html 📝 modified
dev/tutorials/web-extensions/index.html 📝 modified
dev/tutorials/web-getting-started/index.html 📝 modified
user/how-to/list-and-share-applications/index.html 📝 modified
user/how-to/login-out/index.html 📝 modified
user/how-to/monitor-jobs/index.html 📝 modified
user/reference/client-configuration/index.html 📝 modified
user/reference/known-installations/index.html 📝 modified
user/reference/programmatic-usage/index.html 📝 modified
user/tutorials/getting-started/index.html 📝 modified
admin/how-to/install/connect/index.html 📝 modified
admin/how-to/install/convert-cs/index.html 📝 modified
admin/how-to/install/embracing/index.html 📝 modified
admin/how-to/install/install-kubernetes/index.html 📝 modified
admin/how-to/install/installing/index.html 📝 modified
admin/how-to/install/minimal-requirements/index.html 📝 modified
admin/how-to/install/register-a-vo/index.html 📝 modified
admin/how-to/install/register-the-admin-vo/index.html 📝 modified
dev/explanations/components/api/index.html 📝 modified
dev/explanations/components/cli/index.html 📝 modified
dev/explanations/components/client/index.html 📝 modified
dev/explanations/components/db/index.html 📝 modified
dev/explanations/components/routes/index.html 📝 modified
dev/how-to/use-the-demo/swagger/index.html 📝 modified
dev/how-to/use-the-demo/web/index.html 📝 modified
user/reference/programmatic-usage/command-line-interface/index.html 📝 modified
user/reference/programmatic-usage/https-interface/index.html 📝 modified
user/reference/programmatic-usage/python-interface/index.html 📝 modified

Add a CI automation section to the contributing guide covering
automatic draft conversion and PR review reminders. Move project
management content (issue workflow, triage process, GitHub Projects
fields) to a new issue-triage reference page.
@aldbr aldbr force-pushed the docs/contributing-guides branch from c236e68 to 9701a71 Compare March 27, 2026 17:43
@aldbr aldbr marked this pull request as ready for review March 27, 2026 17:44
@aldbr aldbr enabled auto-merge (squash) March 27, 2026 17:44
@aldbr aldbr merged commit 6ee1331 into DIRACGrid:main Mar 27, 2026
29 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants