Preface
Why this book came into being. Its purpose. Why it was created as a GitBook. You may choose to skip this section or just skim it.
Last updated
Was this helpful?
Why this book came into being. Its purpose. Why it was created as a GitBook. You may choose to skip this section or just skim it.
Last updated
Was this helpful?
This book came into being because over the years I found myself trying to explain the same ideas again and again and I wished I had organized those ideas in a coherent and organized way. Some of my explanations got lost along the way, too. Having a structure to hold them together should help my ideas and writing by providing pigeon holes, reference points, and sign posts by which to mark the development of vague ideas as they become more tangible and useful.
Prior to starting this book, I tried presenting my ideas on , , and . None of those venues seemed right for a standalone, easily extensible catalogue of my ideas on Zen and Mashweb. I hope and expect that the present will finally coalesce my words about Zen and Mashweb into one manageable, comprehensible unit.
In addition to drawing together the ideas presented on , , and , this book is meant to connect together all such diverse sources of digital information as exist to help programmers and web developers use, extend, and further develop the framework. Some of it should be comprehensible to many non programmers and non web developers who have only a general knowledge of computers and the web.
Documenting Zen through through a might have these potential benefits:
The documentation can be developed chapter by chapter rather than blog post by blog post and can be longer than the typical white paper.
The documentation can be comprehensive and coherent. A table of contents can lay out the pages even before they are written. Pages can be stubs. Stubbed pages can point to external resources to introduce their topics.
Versions of the book can be identified by , making the intent of each version apparent. (See also .)
between GitBook and GitHub, editing based upon MarkDown, and periodic pulls from the GitHub repository backing up the book ensure that no work on the book will be lost.
(and the corresponding Git repository) can be used to store all versions of the . Not every Git commit must have a version number, but each version of the book should be stored in a commit and have its own tag that is just a semantic version.
The main "diverse sources of digital information" mentioned above that preceded this are:
, with an estimated 1,500 registered users, which is meant to be an attractive and gentle introduction to Mashweb and Zen that many people might enjoy,
hosted on ,
that discusses some of the problems exploiting the web to the fullest,
,
, which is basically just a set of statically served demos, to be maintained for the early release of Zen code for testing and public comment,
, invisible to all but the Mashweb team members,
which documents many of the important development decisions about Zen and , and
the , which can be edited by Mashweb team members.
Tom Elam, April 2, 2021, updated April 23, 2021
(#2), (#3), and (#4) will be replaced by this and be deprecated. Eventually and this will be released together and hosted on a completely revamped (#1).