This SiteStory has focused on two primary parts of the website:
Repositories
Repositories hold a collection of code resources - the main purpose of the site
is to make those accessible. Each is a github repository associated with the
user id JimFawcett. Anyone can download the contents and view individual code
files using github facilities.
Each repository has an associated documentation webpage, linked from this site,
to help users understand what the code does and how it is designed.
Stories
Stories are sequences of site resources - pages, pdf files, etc. - organized into
some form of coherent story. The story you are reading is one of those.
Each story is accessed via the StoryTeller page, linked from the site top menu.
StoryTeller provides controls to sequence through stories, view their table of
contents, and view page specific notes.
Experiments publishing code:
This site is an experiment on ways to publish code. The experiment has several parts:
Can a static website provide an effective user experience?
How to organize a large collection of code resources that scales well with increasing content?
How to help users understand what a repository's code does and how it is designed?
How to balance the use of precious webpage real estate when displaying text, images, and diagrams?
How do we make navigation through a sequence of pages as painless as possible?
Other Experiments
I believe that most of these questions have positive responses, as presented in the previous page.
Note that this is not a scientific
inquiry. The evidence for the success of the experiments is anecdotal. That level of evidence is
insufficient for making scientific claims. However, as engineers, struggling to build effective
mechanisms, we use all the help we can get.
I hope you have enjoyed reading this story. Thanks for your attention. Cheers!