logoalt Hacker News

prependyesterday at 7:49 PM5 repliesview on HN

That time was like 10 years ago. I think it’s been best practice to have docs in the repo for a long time.

GitHub Pages came out in 2008.


Replies

bryanlarsenyesterday at 8:11 PM

The best time to plant a tree was 30 years ago. The second best time is now.

show 2 replies
8noteyesterday at 11:23 PM

if you aren't using github because you're at a big company with its own git UIs, you still have to make the case that your company needs this thing.

I'm sure there's a ton of places where its been hard to do that in the past in a way where the docs are easily accessible where people are looking

but with agents, even just pulling the code package to get the docs is fine

giorgiozyesterday at 8:02 PM

that's true. Take care because in the YCombinator there is "Don't be snarky". Ask yourself how you could have provided the same useful insight without being snarky: https://news.ycombinator.com/newsguidelines.html

show 1 reply
mixmastamykyesterday at 8:40 PM

Python Sphinx as well.