jbw976
commented
5 months ago This looks reasonable to me @plumbis!
A few thoughts:
- I appreciate the attention to creating redirects for all moved pages, so we can avoid old links out there in the wild and search engine results
- actually, we can do an removal of the
/knowledge-basepath in google search when we're ready to, so just let me know when we can do that
- actually, we can do an removal of the
- With
/knowledge-basebeing removed completely, does this mean the left navigation pane will be able to stay completely static as the user navigates to different pages? the dynamic changing of nav pane entires has continuously been jarring for me, so removing that from the experience would be awesome! - I've often thought the Troubleshooting page wasn't a good fit for its current "Configuration Guides" section. Sounds like you'll still keep it in a "Guides" section here. But I think i'm good with that as long as its called "Guides" and not "Configuration Guides". Perhaps the "Configuration" part of the section title was what felt the most misleading to me đ
plumbis
Background
Since the docs reorg in #271 we've had a Knowledge Base section that has been a bit of a catch-all for docs that don't fit into the existing user docs.
Some of this content is older and needs to be revised or removed and some of it is newer, popular content.
@jbw976 also raised two good points in #473 that the KB makes the left-hand navigation dynamic and confusing and that the "Configuration Guides" is a catch-all.
Current Status
The KB currently has 16 pages, sorted here by views in the last 90 days:
Proposal
My proposal is to
/knowledge-basedirectory. All existing URLs will have redirects to their new locations.This doesn't need to be done as a single PR but can be broken up on a per-page or per-section basis. For example, moving pages to Concepts can be on a per-page while the "Learn" section may make more sense as a single action.