Skip to content

Document development and PR review workflows#77

Merged
NeonDaniel merged 2 commits into
masterfrom
doc_developer-workflow
Jun 25, 2026
Merged

Document development and PR review workflows#77
NeonDaniel merged 2 commits into
masterfrom
doc_developer-workflow

Conversation

@NeonDaniel

Copy link
Copy Markdown
Member

Description

Adds Standard Development Workflow document to describe best practices around branch naming, PR management, and rebase operations
Adds Reviewing a Pull Request document to outline the PR review process and considerations

Issues

Other Notes

Open to feedback if this can be better documented or clarified

@NeonDaniel NeonDaniel requested a review from a team June 17, 2026 21:01
Comment thread docs/operations/git/development_workflow.md
Comment thread docs/operations/git/development_workflow.md
Comment on lines +36 to +39
### 2. Review the Code Changes
Code changes should be reviewed for correctness, readability, consistency, and
scope. Much of the review process is subjective, so this document will only aim
to provide guidance for things to look for, rather than a rubric for evaluation.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a suggestion, but we could look at codifying this section into a standardized Agent Skill that could be added to each repo and run by the reviewer as a secondary "AI check" on the PR.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree; we also have #76 which is essentially contributing what could be an Agent Skill. I've made myself a note and will find the right place to document this task

@NeonCharlie-24 NeonCharlie-24 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This all looks good to me! Left two comments on areas I've had trouble with that may benefit from a bit more elaboration.

Unrelated to any changes that need to be made to these documents, I also left a suggestion about potentially adding a standardized Agent Skill to our PR review process.

@NeonDaniel NeonDaniel merged commit 719530e into master Jun 25, 2026
@NeonDaniel NeonDaniel deleted the doc_developer-workflow branch June 25, 2026 00:02
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