Skip to content

Documentation restructure#330

Open
martyn-fewtrell wants to merge 4 commits into
mainfrom
feature/restructure
Open

Documentation restructure#330
martyn-fewtrell wants to merge 4 commits into
mainfrom
feature/restructure

Conversation

@martyn-fewtrell
Copy link
Copy Markdown
Contributor

PR Classification

Documentation restructure and content update.

PR Summary

This pull request restructures the documentation repository for improved clarity, navigation, and consistency, updating content and internal links to match a new organizational scheme.

  • Adds new README files for each top-level area (communities, policies, standards, guidance, reference) with clear entry points and related links.
  • Introduces a comprehensive documentation guidance file detailing documentation modes, structure, and contributor checklists.
  • Updates the main README to serve as a content map with audience journeys and area links.
  • Refactors and relocates policy, standard, and guidance documents, updating references and internal links throughout.
  • Rewrites CONTRIBUTING.md to align with the new structure and document mapping guidance.

Add documentation.instructions.md with detailed authoring guidance, including documentation modes, mapping, and a contributor checklist. Update CONTRIBUTING.md with a mapping table for document types. Revise README.md files to clarify the purpose and navigation of each documentation area.
@snyk-io-eu
Copy link
Copy Markdown

snyk-io-eu Bot commented May 14, 2026

Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues
Licenses 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

Updated list markers in README.md to use consistent Markdown formatting. Changed '-' to '*' and vice versa in relevant sections to align with best practices. No content changes were made.
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.

1 participant