About GuideScape
GuideScape hosts life advice and content to help individuals educate themselves.
Note: Only 5 of 12 planned initial articles are ready (10 explanations and 2 guides). So you may find references to sections that haven't been released yet. If you want to be informed of when they get released, then subscribe to the email newsletter: sendfox.com/guidescape.
How Content is Organized
- "Humans don't read, they skim."
(Table of Contents, headings, bold, callouts, line separators, lists, and highlights are used to make text skim friendly.) - Discoverability of Content (via 1 of 3 methods):
- Browse by Tree
- Browse by Tags
- Search
- Site Layout: Inspired by David Laing's Grand Unified Theory of Documentation.
Differences:- Tutorials and how to guides are merged.
(A tutorial is just a getting started guide) - References are embedded within explanations and how to guides.
(Search makes it easy to find reference materials like definitions regardless of how they're organized.)
- Tutorials and how to guides are merged.
Navigation Tips
TIPS:
- User Experience:
- GuideScape is best viewed using a computer rather than a phone.
- Navigation Tips (Computer):
- Left Menu links to articles.
- Right Menu contains a Table of Contents, with clickable links.
- Navigation Tips (Phone):
- Top Left Button with 3 lines brings up the Navigation Menu.
- Top Grey Button with a dropdown caret contains a Table of Contents.
- Search Tips:
- "Double Quoted String Matching works"
- Minus sign works as an exclude operator. You can use it with words or quoted strings.
- Browse Tags has a limitation of only allowing you to search 1 tag at a time. (If you want to search for the union of multiple tags, you can do so by typing the tags in the search box.)
- Edge Case: If text shows up via search, but doesn't appear on the page via
ctrl+f
That text is likely hidden in a spoiler text drop down. I try to use them sparingly, their intent is to add background contextual information that's skippable in terms of the main point.