docs: reorganize playbook navigation into role-based sections - #1134
Open
vdstrizhkova wants to merge 4 commits into
Open
docs: reorganize playbook navigation into role-based sections#1134vdstrizhkova wants to merge 4 commits into
vdstrizhkova wants to merge 4 commits into
Conversation
added 2 commits
July 16, 2026 09:16
- align wording and tone across observability, security, code-review, and other docs - fix outdated/broken external links and dead references - add cspell terms, gitignore/gitattributes, and mkdocs workflow action bumps 📝 - Generated by Copilot
- lychee surfaces a backlog of pre-existing broken/blocked external links - keep it disabled (as in the source PR) until that backlog is triaged 🔧 - Generated by Copilot
vdstrizhkova
force-pushed
the
feat/docs-restructure
branch
from
July 16, 2026 13:25
d647880 to
f8ac167
Compare
added 2 commits
July 16, 2026 16:46
- add AI-assisted engineering hub (docs/ai-assisted-engineering/README.md) - add generative-AI and agentic systems guidance, including HVE references 🤖 - Generated by Copilot
- add Start Here section with role on-ramps and project kickoff checklist - add Non-Functional Requirements section and update navigation (.pages, READMEs) - rename docs/design/readme.md to README.md; remove superseded first-week page 🗂️ - Generated by Copilot
vdstrizhkova
force-pushed
the
feat/docs-restructure
branch
from
July 16, 2026 16:48
f8ac167 to
3d5c568
Compare
6 tasks
vdstrizhkova
changed the title
vdstrizhkova
marked this pull request as ready for review
July 16, 2026 17:02
vdstrizhkova
requested review from
TessFerrandez,
nyouens and
shiranr
as code owners
July 16, 2026 17:02
6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pull Request Template
What are you trying to address
This is part 2 of 3 splitting PR #1130. It is purely a reorganization of the playbook's information architecture - it adds no new guidance content (the AI/HVE additions live in #1133).
Scope: 12 files changed (+249 / -82) relative to its base.
Reorganization
docs/start-here/README.md,for-engineers.md,for-data-scientists.md,for-leads.md,project-kickoff-checklist.md, and.pages.docs/non-functional-requirements/README.md) consolidating NFR content into its own area.docs/.pages,README.md, anddocs/README.md.docs/design/readme.md->docs/design/README.mdfor consistency.docs/the-first-week-of-an-ise-project.md(superseded by the Start Here section).Checklist
READY TO PR? Use the check-list below to ensure your branch is ready for PR.