microsoft / microsoft/hve-core

docs: update collections overview table with current artifact counts

Open Beginner friendly
#1,414 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

documentation stale-docs
Dominant language
Python
Stars
1.5k
Forks
301
Avg merge
3d 3h
Merged PRs (30d)
92

Description

## Component

Documentation

## Bug Description

`docs/getting-started/collections.md` contains a hand-maintained artifact count table that is now stale after PR #1245 added the `owasp-docker` skill to the `security` and `hve-core-all` collections. The table shows incorrect counts across the `security` and `hve-core-all` rows, and the total artifact count in the introductory text is wrong.

**Current docs vs. actual YAML counts:**

| Collection | Doc: Agents | Doc: Prompts | Doc: Instructions | Doc: Skills | Actual: Agents | Actual: Prompts | Actual: Instructions | Actual: Skills |
|---|---|---|---|---|---|---|---|---|
| `security` | 9 | 14 | 19 | 5 | 9 | 15 | 18 | 10 |
| `hve-core-all` | 51 | 63 | 102 | 12 | 51 | 64 | 101 | 17 |

The introductory text says "221 artifacts" but the `hve-core-all.collection.yml` manifest now contains **233 artifacts**.

## Expected Behavior

The table rows for `security` and `hve-core-all` and the "221 artifacts" introductory text should reflect the current counts sourced from `collections/security.collection.yml` and `collections/hve-core-all.collection.yml`.

## Steps to Reproduce

PR #1245 (`feat(skill): introduce owasp-docker`) added:
- `.github/skills/security/owasp-docker/SKILL.md` (new skill)
- Updated `collections/security.collection.yml` and `collections/hve-core-all.collection.yml` with the new skill entry

`docs/getting-started/collections.md` was not updated in that push.

## Additional Context

- **Stale file:** `docs/getting-started/collections.md` — the `security` and `hve-core-all` rows in the collections table and the "221 artifacts" intro text
- **Source of truth:** `collections/security.collection.yml`, `collections/hve-core-all.collection.yml`
- **Triggering commit:** PR #1245 (feat(skill): introduce `owasp-docker`)
- **Related enhancement:** Issue #1317 proposes auto-generating this page from YAML manifests to prevent future drift; this issue tracks the immediate factual correction needed in the interim.

> [!NOTE]
>
> 🔒 Integrity filter blocked 1 item
>
> The following item were blocked because they don't meet the GitHub integrity level.
>
> - [#435](https://github.com/microsoft/hve-core/issues/435) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
>
> To allow these resources, lower `min-integrity` in your GitHub frontmatter:
>
> ```yaml
> tools:
> github:
> min-integrity: approved # merged | approved | unapproved | none
> ```
>
>

> Generated by [Documentation Update Check](https://github.com/microsoft/hve-core/actions/runs/24691891936/agentic_workflow) · ● 3.6M · [◷](https://github.com/search?q=repo%3Amicrosoft%2Fhve-core+is%3Aissue+%22gh-aw-workflow-call-id%3A+microsoft%2Fhve-core%2Fdoc-update-check%22&type=issues)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open docs/getting-started/collections.md and compare the security and hve-core-all rows with collections/security.collection.yml and collections/hve-core-all.collection.yml. Update the two table rows and introductory total to match the manifests, then verify the documented counts against those YAML source files.

Written by the indexing model from the issue text.

Assessment

Tech stack
markdown, yaml
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.