Ge

Generate documentation sites from Git repositories

Hacker News

Generate documentation sites from Git repositories

I’m sharing an MVP of a tool for building documentation sites directly from Git repositories: https://brodocs.io with auto conversion of PlantUML and draw.io diagrams. All repos appear on left tree menu, but you can also create sites with top menu structure where each menu item directs to subsite with own left menu structure. Examples: https://brodocs.io/94c8be738065bd0c559/Backlog/Intakebacklog... , https://brodocs.io/21a3986b137fb8f4ff8/Backlog/README.html , Who may like it: Large organizations to build central and per team documentation sites from micro (and nano) services docs, Terraform/Ansible modules, solution designs, architecture decision records. Keeping docs as markdown in git allows collaboration through standard PR workflows. Could be an input to construct agents.md or copilot-instructions.md in given area, describing architecture at high level, to get better vibe codes. I see quite often that teams build own sites using some static site generator and CI/CD pipelines, moving away from wiki like Confluence, but it costs some effort to build/maintain and security is missing. Small distributed teams working on startups to have common docs space built from markdown files stored close to source code. When hiring starts, new people need to be on boarded quickly. Individuals who use PKM (Personal Knowledge Management) tools based on markdown, such as VS Code, NeoVim, Obsidian, or Logseq. If you have spent some time to build PKM, you might be using it in read-only mode for some stable parts, so e.g. in restrictive corporate environments where your favorite PKM tool might not be allowed, or don't want to have too many VSC windows open, quick access from a browser could be helpful. The MVP does not require signing up. Login and management app will come next. Happy to hear observations, criticism, and suggestions. How do you prefer to write tech docs at your work, wiki or markdowns in git repo? Do you publish them using some static site generators?

Share card

Actual performance

1points
Did not reach leaderboard

Launch Intel predictions

Analyze your own launch →
Product HuntOn track for Day 1 leaderboard · Strong signals: agents, agent, new · Missing: mac, macos, cursor
92%92% predicted probability of success on Product Hunt, based on ML models trained on real launch data.
best fitHighest predicted score across all platforms for this description.
Hacker NewsStrong engagement from HN community · Strong signals: pipe, io · Missing: https docs, excited, just released
69%69% predicted probability of success on Hacker News, based on ML models trained on real launch data.
nativeThis product was originally launched on this platform.
Indie HackersFits the IH revenue-focused audience · Strong signals: organizations · Missing: supports, reddit linkedin, podcasting
64%64% predicted probability of success on Indie Hackers, based on ML models trained on real launch data.
AppSumoMay struggle as an AppSumo deal · Missing: plus, platform, intuitive
49%49% predicted probability of success on AppSumo, based on ML models trained on real launch data.
TrustMRRLess likely to generate early MRR · Strong signals: personal, way · Missing: mobile apps, ios, entrepreneurs
42%42% predicted probability of success on TrustMRR, based on ML models trained on real launch data.
Acquire.comPre-revenue stage for this audience · Missing: arr, mrr, revenue
16%16% predicted probability of success on Acquire.com, based on ML models trained on real launch data.
BetaListMay not resonate with beta-testers · Missing: web3, chat, crypto
0%0% predicted probability of success on BetaList, based on ML models trained on real launch data.

Incorrect prediction on native model

Similar products

Th
TheDocs – Documentation sites for individuals in minutes51%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

TheDocs – Documentation sites for individuals in minutes

Hacker News7
Ge
Generate static Go documentation sites with godoc-static62%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Generate static Go documentation sites with godoc-static

Hacker News3
Docxy
Docxy28%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Generate React-based documentation sites from markdown files

Indie Hackers2content
HN
HNminus (HN with larger sites omitted)58%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

HNminus (HN with larger sites omitted)

Hacker News11
Octolinks.fr
Octolinks.fr42%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Backlinks pas cher, thématiques, sur des sites avec trafic

Indie Hackerscommitment-full-time
docmd
docmd55%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Generate beautiful, light documentation sites from Markdown.

Product Hunt+13
UnMarkDocs
UnMarkDocs

UnMark your Documentation

BetaList
Kl
KloudTrader Documentation53%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

KloudTrader Documentation

Hacker News1
Th
The Documentation for GoooQo53%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

The Documentation for GoooQo

Hacker News2
Do
Docman – documentation for Postman64%Launch Intel prediction score: how likely this product is to succeed on its source platform, based on its name, tagline, and description.

Docman – documentation for Postman

Hacker News2