☂ [Tracking] Site information architecture restructure #4565
Labels
a.language
Relates to the Dart language tour
e4-months
Can complete in >= 1 month of normal, not dedicated, work
from.team
Reported by Dash docs team member
infra.ia
Relates to the organization of pages and structuring of content
meta.umbrella
Collects multiple related issues
p2-medium
Necessary but not urgent concern. Resolve when possible.
st.triage.ltw
Indicates Lead Tech Writer has triaged
WIP
The site architecture needs to be restructured.
The sections below are the major chunks of work that will go into the site restructure (each will have it's own issue or PR to further elaborate on):
1. Disassemble the Language tour
Dedicated issue: #4588
The first undertaking will be taking apart the language tour by section/topic, and moving those sections directly under "Language" (in the left nav) as separate pages. An "umbrella" topic (e.g. Classes, Types, Concurrency, etc.) can have multiple other concepts under it (e.g. Classes: Constructors, Methods, etc.).
Why?
The language tour contains basically all the information on the site. It's problematic though.
2. Restructure the left nav
Restructuring at least the Language section of the left nav will have to happen in conjunction with breaking down the language tour, since everything will go there.
New left nav will be something like:
As we decide what the rules are, we need to clearly define those somewhere and stick to them.
Define content types
Solution in progress
Clearly defined content types does a couple things:
Create a "Getting Started" guide
Solution in progress
"Getting started" is a single page that points to the most important introductory resources to learn and start using Dart, laid out in the logical, sequential progression of topics, with a short summary about each.
Samples and tutorials overhaul
Solution in progress
This overhaul is less about restructuring in the context of the entire site, and more about cleaning up/ organizing the pages within the section.
Site-wide "Glossary"
#4622
Redirects
Solution in progress
Other top level sections
Solution in progress
Haven't really analyzed Packages, Development, Tools & techniques sections yet, but at the very least their contents should be scrutinized to ensure they're under the appropriate heading. E.g.:
The text was updated successfully, but these errors were encountered: