Skip to main content

About GuideScape

GuideScape hosts life advice and content to help individuals educate themselves.

Note: Only 5 of 8 originally planned initial articles are ready. 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.