Uh oh!
There was an error while loading. Please reload this page.
Updating SDD docs to include new Service page issues - #309
Conversation
✅ Deploy Preview for services-dev-webdevpath ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Hi team! As soon as you approve this approach, I'll add the other issues to our That means that if we decide to add more issues or change anything in terms of our SDD architecture after merging this PR, our PM's (or myself) will open a new one so that we keep our specs as the project source of truth, which means where you are finding all the info you and your AI models need to code. |
Uh oh!
There was an error while loading. Please reload this page.
Have you updated the CHANGELOG.md file? If not, please do it.
Yes.
What is this change?
This PR continues the adoption of our Specification-Driven Development (SDD) workflow for the Services Page.
Instead of duplicating implementation details across the repository, the SDD documents define the product requirements, decisions, and supporting references, while GitHub Issues become the execution layer for individual implementation tasks.
This PR includes:
tasks.mdto reference GitHub Issues instead of maintaining duplicated implementation checklists.references.mdwith the latest design documentation and supporting resources.CHANGELOG.md.The remaining Services Page sections will follow the same approach as new implementation issues are created.
Were there any complications while making this change?
No technical complications.
This PR intentionally simplifies the relationship between the SDD documentation and GitHub Issues to avoid maintaining the same implementation details in multiple places.
The workflow may evolve as the team gains experience using it, and small improvements can be incorporated based on contributor feedback.
How to use this workflow
For every Services Page implementation task:
specification.mddecisions.mdreferences.mdtasks.md.The SDD documents remain the source of truth for requirements, decisions, and supporting references, while GitHub Issues manage implementation work and technical discussion.
How to test
No application functionality was modified.
Review the documentation changes to verify that:
tasks.mdcorrectly references the implementation issue.references.mdincludes the latest supporting documentation.When should this be merged?
After confirming that the proposed Specification-Driven Development workflow supports future Services Page implementation and that the updated documentation accurately reflects the intended development process.