agjohnson
commented
2 years ago Also:
We should have the ability to link to the section headers. Having an id attribute is probably a good start.
Sections have ids currently:
https://read-the-docs-site-community--147.com.readthedocs.build/en/147/about/#authoring
The page feels pretty dense.
The page has a lot of content. There might be some sections to add some vertical padding, but I wouldn't add too much more. In general, it's pretty well spaced, and too much spacing is going to start separating content too much.
There is a ton of content on this page.
Aye. And we have a lot to distill down on this page. I would certainly not expand this page. But consider a few of these pages for comparison:
- https://circleci.com/product/
- https://www.netlify.com/products/
- https://about.gitlab.com/why-gitlab/
- Or https://about.gitlab.com/stages-devops-lifecycle/
Some of the secondary features could be more of a vertical bullet list, but this page doesn't seem any more overwhelming than similar pages on other sites.
ericholscher
This is the old "product" page, which sounded better as "about" instead in the nav. So it's the about page now.
I addressed https://github.com/readthedocs/site-community/issues/123 mostly, focusing mostly on content here. We were missing a lot of features, but still using a lot of words to describe the features we were covering. I focused on clearing up language and focusing on the essentials, and included a few product screenshots, where we haven't had any yet.
I wasn't originally aiming for this to be a full list of features, but ended up putting more features in at the bottom of the page too. Overall copy is much shorter, but more features are described in a single page now.
:books: Documentation preview :books:: https://read-the-docs-site-community--147.com.readthedocs.build/en/147/