Skip to content

Enable Mermaid diagram rendering in guide documentation#64

Merged
Malcolmnixon merged 2 commits intomainfrom
copilot/add-mermaid-support-for-guide
Jan 10, 2026
Merged

Enable Mermaid diagram rendering in guide documentation#64
Malcolmnixon merged 2 commits intomainfrom
copilot/add-mermaid-support-for-guide

Conversation

Copy link
Contributor

Copilot AI commented Jan 10, 2026

The Pandoc build step was not configured to process Mermaid diagram blocks in the guide.

Changes

  • Added --filter node_modules/.bin/mermaid-filter.cmd to the Pandoc invocation in .github/workflows/build_docs.yaml
  • Uses Windows-specific .cmd extension to match the windows-latest runner
  • Leverages existing mermaid-filter@1.4.7 dev dependency

The filter is a no-op when no Mermaid blocks are present, maintaining backward compatibility with existing documentation content.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • googlechromelabs.github.io
    • Triggering command: /usr/local/bin/node node install.mjs (dns block)
  • https://storage.googleapis.com/chrome-for-testing-public/131.0.6778.204/linux64/chrome-linux64.zip
    • Triggering command: /usr/local/bin/node node install.mjs (http block)
  • https://storage.googleapis.com/chromium-browser-snapshots/Linux_x64/1108766/chrome-linux.zip
    • Triggering command: /usr/local/bin/node node install.js (http block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

This section details on the original issue you should resolve

<issue_title>[Feature]: Mermaid support for Guide</issue_title>
<issue_description>### Problem Statement

The Pandoc tool should make use of the mermaid filter

Proposed Solution

Add --filter node_modules/.bin/mermaid-filter.cmd to the pandoc invocation to enable the mermaid filter

Alternatives Considered

No response

Usage Examples

Benefits

The guide can support mermaid diagrams.

Priority

Low - Nice to have

Willingness to Contribute

Yes, I can submit a pull request

Additional Context

No response

Checklist

  • I have searched existing issues to ensure this is not a duplicate
  • I have provided a clear description of the feature
  • I have explained why this feature would be useful</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>
Copilot AI changed the title [WIP] Add mermaid support for Pandoc guide Enable Mermaid diagram rendering in guide documentation Jan 10, 2026
Copilot AI requested a review from Malcolmnixon January 10, 2026 04:41
@Malcolmnixon Malcolmnixon marked this pull request as ready for review January 10, 2026 04:51
@Malcolmnixon Malcolmnixon merged commit 88da97f into main Jan 10, 2026
9 checks passed
@Malcolmnixon Malcolmnixon deleted the copilot/add-mermaid-support-for-guide branch January 10, 2026 04:51
Copilot AI added a commit that referenced this pull request Mar 24, 2026
Apply template changes from PRs #61 and #64:
- code-quality: add 'agent' tool
- code-review: add 'edit' and 'web' tools
- repo-consistency: add 'execute' tool
- requirements: add 'github', 'web', and 'agent' tools
- software-developer: add 'agent' tool
- technical-writer: add 'github' and 'agent' tools
- test-developer: add 'github' and 'agent' tools

All agent tools lists now normalized to canonical order:
[read, search, edit, execute, github, (web,) agent]
Malcolmnixon added a commit that referenced this pull request Mar 24, 2026
…plateDotNetLibrary latest PRs (#128)

* Initial plan

* Apply template updates from TemplateDotNetLibrary

- Add contributor license agreement wording to README.md License section
  (aligns with TemplateDotNetLibrary PR #12)
- Add MSTest V4 Best Practices section to AGENTS.md with antipatterns:
  MSTEST0058 (assertions in catch blocks), Assert.IsTrue for equality,
  collection count checks, prefix checks, and non-public test visibility
  (aligns with TemplateDotNetLibrary PRs #4 and #21)

* Fix linting issues: add 'antipatterns' to cspell dictionary, fix YAML comment indentation

- Add 'antipatterns' to .cspell.yaml words list (technical term used in AGENTS.md)
- Move TODO comments in reqstream OTS YAML files to be above their sequence items
  rather than inside them, to avoid yamllint comment-indentation warnings
  (docs/reqstream/ots-sonarscanner.yaml, ots-weasyprinttool.yaml, ots-pandoctool.yaml)

* Align agent tools YAML frontmatter with TemplateDotNetLibrary template

Apply template changes from PRs #61 and #64:
- code-quality: add 'agent' tool
- code-review: add 'edit' and 'web' tools
- repo-consistency: add 'execute' tool
- requirements: add 'github', 'web', and 'agent' tools
- software-developer: add 'agent' tool
- technical-writer: add 'github' and 'agent' tools
- test-developer: add 'github' and 'agent' tools

All agent tools lists now normalized to canonical order:
[read, search, edit, execute, github, (web,) agent]

* chore: fix repo-consistency agent to fetch most recently merged PRs (PR #65)

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>
Agent-Logs-Url: https://github.com/demaconsulting/TestResults/sessions/e3b945f5-6681-4166-84e4-ea82d0d9f1de

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>
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.

[Feature]: Mermaid support for Guide

2 participants