Restructure the documentation.

[pooja]

The documentation site structure today is not ideal. It's hard for users to know exactly where to go. While this is not so bad today since the docs site is small, it will be harder to change as the site grows (all changed links will need to be manually updated). We should invest some time in aligning on a site structure that we feel good about committing to for the next 2-3 months, and then implement it/migrate over to it asap.

[cwaring]

Completely agree! Organising content with logical grouping, scope for extension and long-term sensible url structures (ensuring we minimise breaking inbound urls) is critical in providing a good learning experience. This should be a topic of its own design sprint so we can always work towards this goal.

[pooja]

Awesome! As part of this, we should also think about how to incorporate lotus docs into the docs site.

[terichadbourne]

Links from filecoin.io to a variety of docs site articles are being broken as the docs site is restructured. I found a couple in response to this thread but there are likely more: https://filecoinproject.slack.com/archives/CEHTVSEG6/p1595015726199500

Any way to programmatically scan the Filecoin website for links that no longer exist on the docs site? Or set up redirects when an article is moved within the docs structure?

From Johnny who also noticed the Slack thread: "Might be worth pinging #infra to set up a redirect for this link. It takes infra 2 seconds to add, and it's handy in case anyone finds that link again (old IPFS version or something)."