📖 [Docs]: README pages now use the standard module landing-page format#638
📖 [Docs]: README pages now use the standard module landing-page format#638Marius Storhaug (MariusStorhaug) wants to merge 5 commits into
Conversation
There was a problem hiding this comment.
Pull request overview
This PR standardizes README.md into a lightweight landing page aligned with the Template-PSModule default, pushing detailed usage guidance into PowerShell help and the generated module documentation.
Changes:
- Replaces the long-form README with a concise module overview.
- Simplifies installation instructions and points users to
psmodule.iofor full documentation. - Adds a brief contributing section directing users to the issue tracker.
Super-linter summary
All files and directories linted successfully For more information, see the GitHub Actions workflow run Powered by Super-linter |
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.
Comments suppressed due to low confidence (1)
README.md:28
- The file ends with a blank line containing trailing whitespace, which can trigger markdown/style linters. Remove the trailing spaces (and optionally the extra blank line).
Issues and pull requests are welcome. Please use the repository issue tracker to report bugs, request features, or discuss improvements.
Super-linter summary
All files and directories linted successfully For more information, see the GitHub Actions workflow run Powered by Super-linter |
Super-linter summary
All files and directories linted successfully For more information, see the GitHub Actions workflow run Powered by Super-linter |
Applies the content-preserving README default: keeps the highlights/use-cases, supported platforms, and a condensed authentication guide (interactive, PAT, GitHub Actions token, GitHub App, Azure Key Vault, GHES/GHEC host, automatic token renewal), instead of deleting them.
| ```powershell | ||
| Connect-GitHubAccount | ||
| ✓ Logged in as system! | ||
| Connect-GitHubAccount -Mode OAuth # OAuth app instead of the GitHub App |
Super-linter summary
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 the getting-started and authentication guide (device flow, OAuth, PAT, GitHub App, Azure Key Vault, GHES/GHEC host, token renewal). Restores that content and adds a Documentation section pointing to the generated command reference and Get-Help.
Super-linter summary
All files and directories linted successfully For more information, see the GitHub Actions workflow run Powered by Super-linter |
Keeps the full README content — the README is the published psmodule.io/GitHub landing page and the only home for the getting-started and authentication guide (device flow, OAuth, PAT,
GH_TOKEN/GITHUB_TOKEN, GitHub App, Azure Key Vault, GHES/GHEC-Host, custom app, automatic token renewal), supported use-cases, platforms, and references.Change is additive: folds the old Command Exploration subsection into a Documentation section that also points to the generated command reference and
Get-Helpwith a real cmdlet.Follows the updated README default (PSModule/docs#61). The per-command reference is generated separately from comment-based help; narrative content stays in the README because that is where it publishes.