Skip to content

feat(template): group example gallery by Diataxis category#125

Merged
gtauzin merged 1 commit into
mainfrom
feat/diataxis-notebook-gallery-grouping
Mar 29, 2026
Merged

feat(template): group example gallery by Diataxis category#125
gtauzin merged 1 commit into
mainfrom
feat/diataxis-notebook-gallery-grouping

Conversation

@gtauzin
Copy link
Copy Markdown
Member

@gtauzin gtauzin commented Mar 29, 2026

Backport from stateful-y/sklearn-optuna#21 (91268db).

Changes

  • Add category field to __gallery__ metadata and group gallery by tutorial/how-to with section headings
  • Extract _build_gallery_cards helper and reuse in API examples section
  • Update examples page intro to describe grouped notebooks
  • Update contribute.md notebook structure guidelines for Diataxis quadrants
  • Create diataxis-notebook-writer skill with tutorial/how-to reference patterns
  • Add companion notebook sections to tutorial-writer and howto-writer skills
  • Add notebook classification step to docs-planner skill

- Add category field to gallery metadata and group by tutorial/how-to
- Extract _build_gallery_cards helper and reuse in API examples
- Update examples page intro to describe grouped notebooks
- Update contribute.md notebook structure guidelines
- Create diataxis-notebook-writer skill with tutorial/how-to patterns
- Add companion notebook sections to tutorial and howto writer skills
- Add notebook classification to docs planner skill

Backported from stateful-y/sklearn-optuna#21 (91268db)
@gtauzin gtauzin merged commit 226fe07 into main Mar 29, 2026
13 checks passed
@gtauzin gtauzin deleted the feat/diataxis-notebook-gallery-grouping branch March 29, 2026 10:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant