Skip to main content

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:

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):
    1. Browse by Tree
    2. Browse by Tags
    3. Search
  • Site Layout: Inspired by David Laing's Grand Unified Theory of Documentation.
    • 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.)

  • 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.