Skip to content

docs: render each workshop page as a collapsed <details> section#1674

Merged
pelikhan merged 3 commits into
mainfrom
copilot/update-docs-rendering-details-html
Jul 21, 2026
Merged

docs: render each workshop page as a collapsed <details> section#1674
pelikhan merged 3 commits into
mainfrom
copilot/update-docs-rendering-details-html

Conversation

Copilot AI commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Replace the single concatenated HTML dump with per-file <details> sections so each workshop page is independently collapsible in the rendered docs.

Changes

  • scripts/build-docs.js: process each .md file individually instead of joining all markdown before rendering
    • Wrap rendered content in <details> (closed by default)
    • Extract the first heading as plain <summary> text (HTML comments are skipped; no YAML frontmatter in workshop files)
    • Fallback title derived from filename slug when no heading found
<details>
<summary>Write Your First Agentic Workflow</summary>
<!-- rendered markdown content -->
</details>

Copilot AI and others added 2 commits July 20, 2026 21:44
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title Render each workshop page as a closed details section docs: render each workshop page as a collapsed <details> section Jul 20, 2026
Copilot AI requested a review from pelikhan July 20, 2026 21:45
Comment thread scripts/build-docs.js Outdated
? headingMatch[1].trim()
: slug.charAt(0).toUpperCase() + slug.slice(1);
const content = marked(markdown);
return `<details>\n<summary>${title}</summary>\n${content}\n</details>`;

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 wrap in h2 header

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done — the summary now wraps the title in an <h2> tag: <summary><h2>${title}</h2></summary>. Committed in fdd7e8c's follow-up.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI requested a review from pelikhan July 21, 2026 03:26
@pelikhan
pelikhan marked this pull request as ready for review July 21, 2026 03:26
@pelikhan
pelikhan merged commit 6b50e53 into main Jul 21, 2026
@pelikhan
pelikhan deleted the copilot/update-docs-rendering-details-html branch July 21, 2026 03:26
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.

2 participants