Skip to content

📖 [Docs]: README links to generated command reference - #85

Closed
Marius Storhaug (MariusStorhaug) wants to merge 4 commits into
mainfrom
docs/standardize-readme
Closed

📖 [Docs]: README links to generated command reference#85
Marius Storhaug (MariusStorhaug) wants to merge 4 commits into
mainfrom
docs/standardize-readme

Conversation

@MariusStorhaug

@MariusStorhaug Marius Storhaug (MariusStorhaug) commented Jul 6, 2026

Copy link
Copy Markdown
Member

The NerdFonts landing page now directs users to the complete published command reference and shows how to discover module commands and example help in PowerShell.

New: Command reference guidance

The README links to the generated documentation at psmodule.io/NerdFonts and includes Get-Command -Module NerdFonts plus Get-Help -Name Install-NerdFont -Examples for in-shell discovery. Existing installation, usage, caching, update, and uninstall guidance remains available on the landing page.


Technical details
  • README.md gains a concise Documentation section; per-command reference remains generated from comment-based help.
  • Integrated current main with merge commit 48551ad so the branch includes the current Zensical documentation build and repository guidance.
  • Implementation plan progress: Add generated reference guidance to the README #98, acceptance criteria 1-3 complete; repository validation and automated review remain.
Changed surface Standards checked Framework docs checked Result
README.md Markdown Process-PSModule module documentation Aligned
Relevant issues (or links)

Copilot AI review requested due to automatic review settings July 6, 2026 06:30
@MariusStorhaug
Marius Storhaug (MariusStorhaug) requested a review from a team as a code owner July 6, 2026 06:30

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Standardizes the repository’s README.md into a lightweight module landing page (aligned with Template-PSModule defaults), moving detailed command usage guidance to PowerShell help and generated documentation.

Changes:

  • Replaces the long, usage-heavy README with a concise description + installation snippet.
  • Adds an explicit documentation link and directs users to Get-Command / Get-Help for command details.
  • Simplifies the contributing section to a short “issues and PRs welcome” statement.

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

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Super-linter summary

Language Validation result
CHECKOV Pass ✅
GITHUB_ACTIONS Pass ✅
GITLEAKS Pass ✅
GIT_MERGE_CONFLICT_MARKERS Pass ✅
JSON Pass ✅
MARKDOWN Pass ✅
NATURAL_LANGUAGE Pass ✅
POWERSHELL Pass ✅
PRE_COMMIT Pass ✅
SPELL_CODESPELL Pass ✅
TRIVY Pass ✅
YAML Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

@MariusStorhaug Marius Storhaug (MariusStorhaug) changed the title Docs: standardize README 📖 [Docs]: README pages now use the standard module landing-page format Jul 6, 2026
Applies the content-preserving README default: keeps the upstream attribution and donation note, prerequisites and the Fonts dependency, a representative usage showcase, and the caching plus update/versioning behavior, instead of deleting them.
Copilot AI review requested due to automatic review settings July 9, 2026 04:15

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread README.md Outdated
Comment on lines +39 to +40
Install-NerdFont -Name 'FiraCode' -Scope AllUsers
Uninstall-Font -Name 'FiraCode*'
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Super-linter summary

Language Validation result
CHECKOV Pass ✅
GITHUB_ACTIONS Pass ✅
GITLEAKS Pass ✅
GIT_MERGE_CONFLICT_MARKERS Pass ✅
JSON Pass ✅
MARKDOWN Pass ✅
NATURAL_LANGUAGE Pass ✅
POWERSHELL Pass ✅
PRE_COMMIT Pass ✅
SPELL_CODESPELL Pass ✅
TRIVY Pass ✅
YAML Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

The README is the published psmodule.io landing page and the only home for prerequisites, upstream attribution/donations, usage, cache locations and inspection, update/versioning semantics, and uninstall guidance. Restores that content and adds a Documentation section pointing to the generated command reference and Get-Help.
Copilot AI review requested due to automatic review settings July 9, 2026 04:51

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread README.md
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Super-linter summary

Language Validation result
CHECKOV Pass ✅
GITHUB_ACTIONS Pass ✅
GITLEAKS Pass ✅
GIT_MERGE_CONFLICT_MARKERS Pass ✅
JSON Pass ✅
MARKDOWN Pass ✅
NATURAL_LANGUAGE Pass ✅
POWERSHELL Pass ✅
PRE_COMMIT Pass ✅
SPELL_CODESPELL Pass ✅
TRIVY Pass ✅
YAML Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

Marius Storhaug (MariusStorhaug) added a commit that referenced this pull request Aug 8, 2026
….1.19 (#91)

NerdFonts now runs its CI and documentation builds through
Process-PSModule v6.1.19, with dependency compatibility and
documentation links aligned so contributors get reliable build, test,
and site-generation results.

## Changed: CI and documentation builds

The repository now uses the latest Process-PSModule release and builds
the documentation site with Zensical. The site build remains enabled,
and no contributor action is required beyond the existing workflow and
documentation conventions.

## Fixed: build and test compatibility

Dependency bounds, canonical documentation links, temporary download
paths, and cache-fallback coverage now match the current pipeline
expectations. The workflow passes only the API key it needs instead of
inheriting all repository secrets.

---
<details>
<summary>Technical details</summary>

- Updated `.github/workflows/Process-PSModule.yml` to Process-PSModule
v6.1.19 and explicit `APIKey` wiring.
- Updated `actions/checkout` to v7.0.1 in `Update-FontsData.yml`.
- Replaced `.github/mkdocs.yml` with `.github/zensical.toml`; the site
build is enabled in `.github/PSModule.yml`.
- Updated `Fonts` and `Admin` dependency minimums and maximum bounds in
`Install-NerdFont.ps1`.
- Switched font downloads to the system temporary directory.
- Replaced mocked cache-fallback behavior with a live locked-file
scenario.
- Added trailing slashes to canonical documentation links and added the
missing contribution/documentation guidance.
- Standards and framework alignment:

| Changed surface | Standards checked | Framework docs checked | Result
|
| --- | --- | --- | --- |
| `.github/workflows/**` | GitHub Actions, secret handling |
Process-PSModule workflow contract | Aligned |
| `.github/zensical.toml` | Documentation configuration |
Process-PSModule site pipeline | Aligned |
| `src/**`, `tests/**` | PowerShell dependencies, testing |
Process-PSModule source/test checks | Aligned |
| `README.md`, `CONTRIBUTING.md` | Documentation | Repository
contribution guidance | Aligned |

- Issue convergence sweep: reviewed related open work and incorporated
the system temporary-directory and README documentation changes in this
delivery.

</details>

<details>
<summary>Relevant issues (or links)</summary>

- PSModule/Process-PSModule#444 — wildcard `MaximumVersion` parsing was
tracked upstream; current Process-PSModule releases include the upstream
fix.
- #69 — system temporary directory for font downloads.
- #85 — README documentation link.

</details>

---------

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@MariusStorhaug
Marius Storhaug (MariusStorhaug) marked this pull request as draft August 8, 2026 17:11
@MariusStorhaug Marius Storhaug (MariusStorhaug) changed the title 📖 [Docs]: README pages now use the standard module landing-page format 📖 [Docs]: README links to generated command reference Aug 8, 2026
@github-actions

github-actions Bot commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

No Significant Changes Detected

This PR does not contain changes to files that would trigger a new release:

Pattern Description
^src/ Matches files where path matches this pattern
^README\.md$ Matches files where path matches this pattern

Build, test, and publish stages will be skipped for this PR.

If you believe this is incorrect, please verify that your changes are in the correct locations.

@github-actions

github-actions Bot commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

No Significant Changes Detected

This PR does not contain changes to files that would trigger a new release:

Pattern Description
^src/ Matches files where path matches this pattern
^README\.md$ Matches files where path matches this pattern

Build, test, and publish stages will be skipped for this PR.

If you believe this is incorrect, please verify that your changes are in the correct locations.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot wasn't able to review any files in this pull request.

@MariusStorhaug

Copy link
Copy Markdown
Member Author

Closing as obsolete: current main already contains the complete README documentation landing-page update, leaving this PR with no remaining diff.

@MariusStorhaug
Marius Storhaug (MariusStorhaug) deleted the docs/standardize-readme branch August 8, 2026 17:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add generated reference guidance to the README

2 participants