Docs as Code for Vibe Coders and Agents
Postedabout 2 months ago
mvp.brodocs.ioTechstory
supportivepositive
Debate
0/100
Documentation ToolsMarkdownGit Repositories
Key topics
Documentation Tools
Markdown
Git Repositories
The post showcases 'Brodocs', a markdown site builder from git repositories, sparking interest among HN users for its potential use in small distributed teams.
Snapshot generated from the HN discussion
Discussion Activity
Light discussionFirst comment
N/A
Peak period
1
Start
Avg / period
1
Key moments
- 01Story posted
Nov 13, 2025 at 4:51 AM EST
about 2 months ago
Step 01 - 02First comment
Nov 13, 2025 at 4:51 AM EST
0s after posting
Step 02 - 03Peak activity
1 comments in Start
Hottest window of the conversation
Step 03 - 04Latest activity
Nov 13, 2025 at 4:51 AM EST
about 2 months ago
Step 04
Generating AI Summary...
Analyzing up to 500 comments to identify key contributors and discussion patterns
ID: 45912878Type: storyLast synced: 11/17/2025, 6:03:30 AM
Want the full context?
Jump to the original sources
Read the primary article or dive into the live Hacker News thread when you're ready.
Who may like it: - Small distributed teams working on startups to have common docs space built from markdown files stored close to source code. Some of these files may be combined into `agents.md` or `copilot-instructions.md' to get better vibe codes . - Individuals who use PKM (Personal Knowledge Management) tools based on markdown, such as VS Code, NeoVim, Obsidian, or Logseq. If you have already spent some time to build PKM, you might be using it in read-only mode for some parts, so in restrictive corporate environments where your favorite tool might not be allowed quick access from a browser could be helpful. - Larger companies to build central and per team documentation sites from all micro (and nano ) services docs, Terraform/Ansible modules, solution designs, EA docs. Keeping docs as markdown in git allows collaboration via standard pull requests. May be an input to construct `agents.md` or `copilot-instructions.md` in given area.
The MVP does not require account creation. Login and management app will come next.