Hacker News new | ask | show | jobs
by gav 2676 days ago
There's a list of things that should be right there on the project homepage:

- What is this project?

- Who is the intended audience?

- Why would I use it?

- How does it compare to other projects?

- Where should I go for help/support, i.e. where is the mailing list/forums/etc.

- How can I get up and running with the minimum of effort?

2 comments

A lot of proprietary projects don't even do that. The project homepage is targeted at managers so to a programmer it often comes across as meaningless marketing blurb (IMHO).
- why might I not want to use it?
I really appreciated the "drawbacks" link on the sidebar at migadu.com. If you know there are use cases that don't fit your goals, admit them up front.