The script is first-generation though. It's slowly had functionality added to it, but it's getting unmaintainable. I also have a better idea of what its core competencies need to be.

So, this will be a ground-up rewrite.

Overall goals

• make it slightly more polished/professional, in case prospective employers look at it (even a peer like Roger)
• make it easier/quicker/more-friendly for human readers to use
  • there are two people who've confirmed they read it semi-regularly,
  • its original goal (to be good Google bait) has already been well-achieved, but being computer-readable and human-readable are two different things
• make the back-end more flexible, easier to add more features (a few more features now, and possibly other features in the future)
• make the front-end more flexible, integrating as many jQuery tricks as I want
• make it generic enough to run on any of my websites — don't make it so tied-down to paperlined.org specifically

End-user requirements

• there should be a "sitemap" page, a list of all the important directories (directories only, not files), laid out in a tree fashion
• (optional) Each page should have a standard header + footer + navbar, like most normal sites have
  • if we go this way, then the header should include a "friendly" version of the directory navigation. eg:
    Vechiles > Bicycle > Camping

Internal requirements

• directory and document settings should be specified in that directory and as close to that document as possible — having all the settings in one central place has become a huge mess, and it makes it harder to use on other websites
• There should be more "classes" of documents. Some of these "classes" will require a separate file (e.g. /index.html, /friends/index.html, and /private/index.html)
  • documents than anyone can read
    • "polished" — intended audience = other people
    • "draft" — intended audience = other people, but it may not be polished enough to be published yet (though these will still be visible to people if they really want to see them)
    • "internal" — intended audience = only myself (again though, people will be able to view these if they really want to)
  • documents that only friends can read
  • documents that only I can read
• the main page should be AJAX-based, so that when users check/uncheck certain checkboxes, that it dynamically updates the page as quickly as possible
  • even when "/index.html" is accessed, if it has the 'friends' checkbox checked, then it should, in the background, load "/friends/index.html"
• when the user hovers over a page link, it should pop up a summary of some sort
  • TODO: decide if I want this summary to be: A) a hand-entered summary, B) an auto-generated text summary, or C) a "thumbnail screenshot" of the webpage

Design

• each directory can have a ".metadata" file, and that file can change any of the available settings for all files in all sub-directories
• any document (for example, "document.txt") can have an associated metadata file (for that example, it'd be called ".document.txt.metadata") that can do per-document settings