undefined | Better HN

0 pointsnumber64y ago0 comments

There is this tool: sphinx. Helps you making documentation + website. Can read you code and document it with your docstrings. Generates some okish documentation and is kind of boilerplate if you create a library.

There do all these websites come from.

0 comments

3 comments · 1 top-level

vladvasiliu4y ago· 2 in thread

Sure, for example Rust has rustdoc that does the same thing, but there's a common repository for documentation, kind of like pip is a common repository for libs in Python.

There are connectors for ReadTheDocs to generate the Sphinx docs from GitHub, and probably from elsewhere, too. Yet many projects prefer to host the docs on some random domain.

number6OP4y ago

Just think of it: You start your lib, it becomes fairly popular; you think wow this deserves its own domain. Now it's more like a chore than a pet project, plus no one donates to your awesome lib - yes you believe in OSS, but BigBuckCorp who is using your lib could at least chip in. It is all a drag now, so you decide to move on, you owe them nothing, and they are giving you nothing. So years later your credit card expires, and you have to update it to update the domain, and you will definitely do it if you come to it but not now. And it's gone. Screw this...

formerly_proven4y ago

> Yet many projects prefer to host the docs on some random domain.

The overwhelming majority of Python projects (and many non-Python projects as well) host their documentation/website on projectname.rtfd.io

j / k navigate · click thread line to collapse