filecoin-project / filecoin-docs

Filecoin Docs
https://docs.filecoin.io
222 stars 297 forks source link

[UXIT-1706] Enhance Clarity and Consistency in ‘What is Filecoin’ Section #2330

Closed mirhamasala closed 2 weeks ago

mirhamasala commented 1 month ago

This PR improves readability and consistency in multiple sections of the Filecoin documentation, including updates to language flow, terminology alignment, and clearer explanations in key areas such as the storage model, retrieval market, blockchain, crypto-economics, networks, and programming on Filecoin.

mirhamasala commented 2 weeks ago

@smagdali - I quite like the visual hierarchy that capitalising heading provides. And was planning for us to implement it throughout the docs. Following your comment, I reverted it.

This is great. I'm definitely not a fan of American-style 'Capitalising All Headings No Matter What' though, and that's not what we do elsewhere on the site?

Huh, the readme.md on github used to have a style guide in it, I guess Johnny deleted it when we moved to Gitbook.

Yes, a style guide would be helpful.

~ Requested changes have been implemented but the link checker is not happy - I don't have enough information to know what to do about those.