Skip to content

Add portfolio management docs#66

Merged
nscuro merged 1 commit into
mainfrom
portfolio-mgt-docs
Jun 1, 2026
Merged

Add portfolio management docs#66
nscuro merged 1 commit into
mainfrom
portfolio-mgt-docs

Conversation

@nscuro
Copy link
Copy Markdown
Member

@nscuro nscuro commented May 7, 2026

No description provided.

@nscuro nscuro added the enhancement New feature or request label May 7, 2026
@nscuro nscuro force-pushed the portfolio-mgt-docs branch from c334768 to 54faea3 Compare May 9, 2026 13:57
@nscuro nscuro force-pushed the portfolio-mgt-docs branch 2 times, most recently from 9ae2ef5 to ce60f94 Compare June 1, 2026 17:33
@nscuro nscuro marked this pull request as ready for review June 1, 2026 17:33
Copilot AI review requested due to automatic review settings June 1, 2026 17:33
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a portfolio-management documentation set: a new About projects concept page, a companion About tags concept page, two user guides (organizing hierarchies, managing versions), one administration guide (project retention), a new Projects reference page, and small cross-link/contract updates so existing pages point into the new set.

Changes:

  • New Concepts pages for projects and tags, plus cross-links from access-control, component-policies, vulnerability-policies, and changes-in-v5.
  • New user guides for organizing projects into hierarchies and managing project versions, plus a new admin guide for project retention; registered in their respective .pages nav files.
  • New reference/projects.md (classifiers, collection logic, identity/identifiers, tags/properties, retention controls) and a "Surface language" section added to context/diataxis-contract.md.

Reviewed changes

Copilot reviewed 17 out of 29 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
docs/concepts/projects.md New concept page covering the project model, hierarchy, collection projects, versions, retention, ACL.
docs/concepts/tags.md New concept page describing tags and how they differ from project properties.
docs/concepts/access-control.md Adds a "See also" link to the new projects concept page.
docs/concepts/component-policies.md Links "tags" to the new tags concept page.
docs/concepts/vulnerability-policies.md Links "project tags" to the new tags concept page.
docs/concepts/changes-in-v5.md Documents the new retention policies as a v5 change.
docs/concepts/.pages Registers the two new concept pages in the nav.
docs/guides/user/organizing-projects.md New guide on parents, collection projects, and collection logic.
docs/guides/user/managing-project-versions.md New guide on cloning versions, the latest flag, retiring versions, retention.
docs/guides/user/.pages Registers the two new user guides.
docs/guides/administration/configuring-project-retention.md New admin guide for the retention maintenance task.
docs/guides/administration/.pages Registers the retention admin guide.
docs/reference/projects.md New reference page (classifiers, collection logic, identity, identifiers, tags/properties, retention).
docs/reference/permissions.md Adds cross-links to the two new portfolio user guides.
docs/reference/badges.md Notes UUID/(name, version)/name-only badge URL resolution.
docs/reference/.pages Registers the new projects reference page.
context/diataxis-contract.md Adds a "Surface language" section governing UI vs. API/config vocabulary per Diataxis type.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/guides/user/managing-project-versions.md Outdated
Comment thread docs/guides/user/managing-project-versions.md Outdated
Comment thread docs/guides/administration/configuring-project-retention.md Outdated
Comment thread docs/concepts/tags.md
Comment thread docs/concepts/projects.md
@nscuro nscuro force-pushed the portfolio-mgt-docs branch from ce60f94 to 3c39db5 Compare June 1, 2026 17:44
Signed-off-by: nscuro <nscuro@protonmail.com>
Copilot AI review requested due to automatic review settings June 1, 2026 17:51
@nscuro nscuro force-pushed the portfolio-mgt-docs branch from 3c39db5 to bbc0c28 Compare June 1, 2026 17:51
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 18 out of 30 changed files in this pull request and generated no new comments.

@nscuro nscuro merged commit 0fd0569 into main Jun 1, 2026
6 checks passed
@nscuro nscuro deleted the portfolio-mgt-docs branch June 1, 2026 17:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants