Hacker News
new
|
past
|
comments
|
ask
|
show
|
jobs
|
submit
login
cwillu
3 days ago
|
parent
|
context
|
favorite
| on:
Copyparty, the FOSS file server [video]
https://github.com/9001/copyparty/
AdmiralAsshat
3 days ago
[–]
Good god, that's a long landing page. It's like they shoved the whole wiki into the readme.
reply
jordemort
3 days ago
|
parent
|
next
[–]
This is actually my favorite style of documentation. Just hit me over the head with the whole thing, I can take it.
reply
medstrom
2 days ago
|
root
|
parent
|
next
[–]
Plus, in my experience when I make a separate user manual... a lot fewer people read it.
reply
yjftsjthsd-h
2 days ago
|
parent
|
prev
|
next
[–]
Yes, but it starts with an overview, table of contents, and quickstart, so I see no downsides to that approach and lots of upsides.
reply
vinnymac
2 days ago
|
parent
|
prev
[–]
Most repositories try to create a poor man’s wiki inside of their README. It’s better this way until that problem is solved.
The other style I like is a single sentence with a single link to the actual wiki.
reply
Guidelines
|
FAQ
|
Lists
|
API
|
Security
|
Legal
|
Apply to YC
|
Contact
Search: