📖 [Docs]: README pages now use the standard module landing-page format

[Marius Storhaug (MariusStorhaug)]

📖 [Docs]: Standard module landing-page README

The Markdown README is now a focused landing page that follows the standard PSModule format, so users get a clear
what/why, a one-command install, and a runnable showcase without wading through content that duplicates command help.

User-facing changes

• Usage restored, using the real commands. A concise ## Usage section shows how to compose a document with
  Set-MarkdownSection, Set-MarkdownTable, Set-MarkdownCodeBlock, Set-MarkdownDetails, and Set-MarkdownParagraph.
  (The previous PR had removed the entire Usage section along with the old DSL example.)
• Working help snippet. The discovery example is now Get-Help -Name Set-MarkdownTable -Examples instead of the
  placeholder Get-Help <CommandName> -Examples.
• Install-PSResource for installation and a psmodule.io/Markdown documentation pointer (unchanged from standard).
• Removed ## Contributing. Contribution guidance is not part of the published landing page.

Only README.md changed.

[Copilot]

Pull request overview

This PR standardizes README.md into a lightweight landing page for the PowerShell module, shifting detailed usage guidance to PowerShell help and the generated documentation site.

Changes:

• Replaces the long, example-heavy README content with a short module summary and minimal installation instructions.
• Adds a documentation section linking to the published module docs and pointing users to Get-Command / Get-Help for usage details.
• Simplifies the contributing section to a brief “issues and PRs welcome” statement.

---

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

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	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

[Copilot]

Pull request overview

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

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	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

[Copilot]

Pull request overview

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