Ask HN: What are some software projects with impressive websites?

10 points by siddthesquid 6 days ago

I am looking for some inspiration at websites for software projects that do a very good of job explaining their product right from the get go. Things like programming language or database home pages/docs or open source projects with good git READMEs.

Though I've never used it, I think https://ziglang.org/ is a great example as it explains what makes the language unique, gives a code example right at the beginning, and makes it clear where to find more samples so I can quickly judge the features of the project without having to go through the entire docs.

Maybe this is debatable, but I feel like https://kubernetes.io/ is a counter example. It's one of my favorite tools, but the home page doesn't tell me much. I think I would have liked to see code snippets about Deployments or some sort of architecture diagram that explains what it does in terms of different well established protocols like cri-o or cgroups or something. (Honestly the k8s docs are not so bad - I'm sure there are better counter examples that are super marketing heavy).

You might disagree with my examples above, but I'm still curious to see what other people consider "good" in terms of relaying useful information.

tom1337 5 days ago

The https://mantine.dev docs rule. They provide a lot of examples on the landing page and if you navigate through the page each component has a great explainer with a playground and all possible settings you can give. Direct with links to the source code and a great CMD+K search.

  • siddthesquid 5 days ago

    Great example. would not expect anything less from a project focused on UI elements. https://www.chakra-ui.com/ as well.

    Blog posts and websites that talk about web UI theory or features that demo their components natively on their site definitely stick out and is a sign of a good developer team. I understand if sites otherwise can't include them because they are using a blog or doc generating/hosting service, but they lose the opportunity of sticking out.

lukeweston1234 5 days ago

https://supabase.com/ is very clean with a nice information hierarchy.

https://www.postgresql.org/ despite being quite technical, these docs are very easy to follow in a self learning format.

The new Angular and React docs are quite nice.

  • siddthesquid 5 days ago

    I like that all the products of Supabase are front and center with clear and concise descriptions of them and good landing pages with each of them. They all give (IMO) an optimal level of detail.

    The "New to Postgres?" link I agree has a good description and makes its exact technical features easy to grok.

    Thanks for sharing, awesome examples.