Open source GitBook alternatives

Docusaurus 2.0

“> I like include asciidoctor[1] and mdbook [2]. Though I find that even those are overkill for my hobby projects at least ... That's one thing: Docusaurus is not necessary just for hobby projects where the doc only exists for yourself and a few users. It can be used for hobby…”

Docusaurus 2.0

“brabel that's fair, I also like simple things btw. Can you please share your doc site, so that I can at least know what kind of docs experience you are building? Tailwind is not something we support atm, and when we'll do it will be optional. The only choices you cannot opt-out…”

I spent two years trying to do what Backstage does for free

“Indeed, Backstage is a framework for creating a developer portal, not a ready-made product. I used to work on a consultancy ( ) who's specializing in adopting Backstage at Fortune 500s like HP. When you adopt Backstage at scale, you rely on processors that scan your LDAP,…”

I spent two years trying to do what Backstage does for free

“It's capitalized in the title, so it's a PROPER noun. And I've worked in software development for a long time, and have read HN regularly for a long time, and I've never heard of "Backstage" as software. There's a wide world out there, which some HN posters "forget."”

Show HN: MkDocs Material Boilerplate – Starter Kit

“This is nice. However, isn't this just having a boilerplate starter kit for deploying MkDocs sites to various providers (GitHub Pages, GitLab, AWS Amplify, etc) using the MkDocs Material template theme built by Squidfunk ( )? If so, it would probably be good to add a citation if…”

Show HN: MkDocs Material Boilerplate – Starter Kit

“I released MkDocs Material Boilerplate (Starter Kit) Deploy documentation to platforms (Netlify, GitHub Pages, GitLab Pages, and AWS Amplify Console) with Docker, pipenv, and CI/CD”

VitePress 1.0

“There is a discussion related to naming on GitHub: Given that version 1 landed as "VitePress" they probably decided to keep the name. > I initially gave VitePress a different name because I wanted to be able to explore a different architecture without worrying about backwards…”

VitePress 1.0

“VitePress has a great development experience but we ended up running into several issues with our large (500+ pages) docs site with several broken pages with broken rendering, duplicate & missing content, etc. that took too long to identity and resolve that we ended up porting…”

Nextra 3

“below of my thoughts on the next biggest release - [x] allow only ESM config `next.config.mjs` or `next.config.js` with `"type": "module"` > the whole nextra should be bundled to ESM only instead of mixing cjs and esm > also this should fix blocked renovate PRs which one now ESM…”

Module build failed: UnhandledSchemeError: Reading from "D:testapp.nextstaticchunks extra-page-map-.mjs" is not handled

“``` D:testapp.nextstaticchunks extra-page-map-.mjs Module build failed: UnhandledSchemeError: Reading from "D:testapp.nextstaticchunks extra-page-map-.mjs" is not handled by plugins (Unhandled scheme). Webpack supports "data:" and "file:" URIs by default. You may need an…”

Rewrite the docs

“### What problem will this feature address? Few years ago, I built fumadocs. At the time, I wasn't experienced in authoring docs, especially in making tutorial content. This makes the docs of fumadocs became messy and unfriendy for beginners. I think we really need a rewrite of…”

Gorilla Youngsters Seen Dismantling Poachers’ Traps (2012)

“Intelligence is clearly useful for almost everything. And that's exactly my point. The closer we look the more intelligence we find in nature. But there's a tremendous qualitative gap between human-type intelligence and everything else. When we believed other animals were dumb…”

Gorilla Youngsters Seen Dismantling Poachers’ Traps (2012)

“Could the gorillas be the poachers? The story seems consistent with the gorrilas warning the tracker by grunt to stay put, then dismantle their nearby traps to protect the humans. This is also consistent with the fact that the tracker hadn't noticed the second trap. I don't…”

The Starlight Lines Employee Forum RPG

“I administer a small vBulletin forum that I inherited from a friend who inherited it from... well, whatever, this thing's been around for over a decade now. A few years ago we discovered that we had parasites ! Apparently, that version of vBulletin had some sort of secondary…”

The Starlight Lines Employee Forum RPG

“Hey, yoz! Thanks for the shout-out. That is probably my favorite post of mine on the site (out of 100+ and counting). So wonderfully serendipitous and fun. Everything about that game is a joy. I was actually looking back into some of the Starlight Lines forum stuff a few months…”

Run Graphql-voyager broken

“I try to run locally Graphql-Voyager, but the graph is not loading, due > Failed to load Redirect from ' to ' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin ' is therefore not allowed access. If an opaque…”

Angular integration

“Is there any way to integrate this incredible tool into angular project? I mean there is some info about integration into react project, but nothing about angular”

Pdoc – Generate API documentation for Python projects

“Pdoc is great. I love it. But there is one blemish. They write on documenting variable assignments which don't support pythons __doc__ string: > To compensate, pdoc will read the abstract syntax tree (an abstract representation of the source code) and include all assignment…”

Pdoc – Generate API documentation for Python projects

“not sure if this is a typo or a misunderstanding, but to be clear: pdoc does not treat a comment immediately below a variable declaration as a docstring, it treats an unassigned string immediately following a variable declaration as a docstring, same as how python treats an…”