Introducing Open Web Docs

Re:Introducing Open Web Docs by franciscop on Tuesday January 26, 2021 @03:50AM (#25913769)

It retracts from the credibility of a documentation platform that the blog post announcing it makes one of the most basic mistakes of writing text online; line length should be kept to 60-80 characters to make it readable. It can be stretched a bit up to 100 chars depending on font-size, line-height, etc, but this blog post features a whooping 163!

[ Parent | on HN ]

Re:Introducing Open Web Docs by gnomewascool on Tuesday January 26, 2021 @03:59AM (#25913800)

> that the blog post announcing it makes one of the most basic mistakes of writing text online

Your comment is a valid criticism of the Open Collective website (if you at all feel like it, please send it directly to them — see the bottom of the webpage), but it's not the fault of the "Open Web Docs" project. They probably have little more influence on the design of the website than somebody using indiegogo, patreon or kickstarter has on the respective platforms.

[ Parent | on HN ]

Re:Introducing Open Web Docs by piamancini on Tuesday January 26, 2021 @09:10AM (#25915895)

Hi - Pia from Open Collective here. Thanks for the ping on this. We deployed a quick fix to reduce the width and we'll look at it with more time.

[ Parent | on HN ]

Re:Introducing Open Web Docs by franciscop on Tuesday January 26, 2021 @04:13AM (#25913869)

From the wording, naming and UI I thought that Open Collective itself was introducing this project!

[ Parent | on HN ]

Re:Introducing Open Web Docs by piamancini on Tuesday January 26, 2021 @09:10AM (#25915903)

Hi Francisco - Pia from Open Collective here. Thanks for the ping on this. We deployed a quick fix to reduce the width and we'll look at it with more time.

[ Parent | on HN ]

Re:Introducing Open Web Docs by franciscop on Tuesday January 26, 2021 @10:17AM (#25916676)

That's much better and more readable! Thanks for the super-quick fix!

[ Parent | on HN ]