Skip to content

prompt: add documentation guidance for markdown anchor links#249

Open
blinkagent[bot] wants to merge 1 commit intomainfrom
prompt/docs-markdown-guidance
Open

prompt: add documentation guidance for markdown anchor links#249
blinkagent[bot] wants to merge 1 commit intomainfrom
prompt/docs-markdown-guidance

Conversation

@blinkagent
Copy link
Contributor

@blinkagent blinkagent bot commented Feb 6, 2026

Summary

Adds a <documentation> section to the system prompt with guidance for writing markdown docs:

  • Avoid using raw HTML tags like <a id="..." for anchor links
  • Use standard markdown heading anchors that are auto-generated
  • Check the repository's existing docs for patterns first

Context

This came up while working on coder/coder#21656 - I used an <a id> tag to create a custom anchor, which wouldn't work with the docs renderer. Danny caught it in review.

Most static site generators (including the one used for Coder docs) auto-generate anchors from headings, so raw HTML anchors are unnecessary and potentially unsupported.


Created on behalf of @bjornrobertsson

@vercel
Copy link

vercel bot commented Feb 6, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
blink Ready Ready Preview, Comment Feb 6, 2026 9:58am

Request Review

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.

0 participants