Skip to content

docs: add content to how-to landing pages - #1316

Open
asanvaq wants to merge 3 commits into
canonical:mainfrom
asanvaq:ROCKS-3348-landing-pages
Open

docs: add content to how-to landing pages#1316
asanvaq wants to merge 3 commits into
canonical:mainfrom
asanvaq:ROCKS-3348-landing-pages

Conversation

@asanvaq

@asanvaq asanvaq commented Aug 2, 2026

Copy link
Copy Markdown
Collaborator

The following landing pages in the how-to section do not fit the required model:

  • Crafting
  • Chiseling
  • Documentation

This PR updates them to fit the model. Metadata descriptions have also been added to those missing them.


  • I've followed the contribution guidelines.
  • I've signed the CLA.
  • I've successfully run make lint && make test.
  • I've added or updated any relevant documentation.
  • In documents I changed, I added a meta description if one was missing.
  • I've updated the relevant release notes.

Copilot AI review requested due to automatic review settings August 2, 2026 19:14

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

Updates Rockcraft’s “How-to” landing pages to better match the project’s landing-page model by adding missing meta descriptions and providing short, curated entry points into each how-to area.

Changes:

  • Added/updated .. meta:: :description: blocks for how-to landing pages that were missing or overly generic.
  • Expanded the Crafting and Chiseling landing pages with short overviews and curated :ref: link lists, while hiding the underlying toctrees.
  • Added a brief introductory sentence to the Documentation landing page and normalized its toctree entries.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
docs/how-to/index.rst Adds a meta description for the how-to landing page.
docs/how-to/documentation/index.rst Adds a short intro line and normalizes the toctree entry format.
docs/how-to/crafting/index.rst Reworks the landing page into a modeled overview with curated links and a hidden toctree.
docs/how-to/chiseling/index.rst Adds meta description and a curated overview with hidden toctree for chiseling how-tos.

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

Comment thread docs/how-to/chiseling/index.rst Outdated
@asanvaq
asanvaq marked this pull request as ready for review August 2, 2026 19:21
@asanvaq
asanvaq requested review from a team and tigarmo as code owners August 2, 2026 19:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants