New architecture diagram and docs updates

editions/tw5.com/tiddlers/dev/TiddlyWiki Architecture.tid

@@ -0,0 +1,19 @@
+created: 20130825162100000
+modified: 20140318211655525
+tags: dev
+title: TiddlyWiki Architecture
+type: text/vnd.tiddlywiki
+
+The heart of TiddlyWiki is an extensible representation transformation engine for text and images. Given the text of a tiddler and its associated ContentType, the engine can produce a rendering of the tiddler in a new ContentType. Furthermore, it can efficiently selectively update the rendering to track any changes in the tiddler or its dependents.
+
+! Overview
+
+The following diagram shows the internals of TiddlyWiki as a stack of tiddlers above a processing pipeline that converts WikiText into HTML.
+
+{{TiddlyWiki Architecture.svg}}
+
+The processing pipeline shows how WikiText is parsed by a stack of parse rules into a parse tree. The parse tree is rendered as a tree of widgets, which is synchronised into the DOM via the RefreshMechanism.
+
+DOM events trigger actions on widgets which update the tiddler store. The updates trigger a change event which in turn triggers the refresh mechanism to update the DOM.
+
+

editions/tw5.com/tiddlers/dev/TiddlyWiki for Developers.tid

@@ -1,14 +1,14 @@
 created: 20131203074550710
-modified: 20140226083600000
+modified: 20140318210720798
 tags: introduction dev
 title: TiddlyWiki for Developers
 type: text/vnd.tiddlywiki
 
-TiddlyWiki is published as OpenSource which means that anyone can read the code and contribute to its development. It's a big, complex piece of software and can be overwhelming to newcomers.
+TiddlyWiki is published as OpenSource which means that anyone can read the code and contribute to its development.
 
 ! Resources
 
-If you're interested in understanding more about the internal operation of TiddlyWiki, start by reviewing [[TiddlyWiki for Developers]] and then read the code -- start with the boot kernel [[$:/boot/boot.js]].
+If you're interested in understanding more about the internal operation of TiddlyWiki, [[TiddlyWiki Architecture]] gives an overview of how TiddlyWiki is structured. Then read the code -- start with the boot kernel [[$:/boot/boot.js]].
 
 ! The one thing you need to know
 

editions/tw5.com/tiddlers/dev/TiddlyWikiArchitecture.tid

@@ -1,9 +0,0 @@
-created: 20130825162100000
-modified: 20131212093605368
-tags: dev
-title: TiddlyWikiArchitecture
-type: text/vnd.tiddlywiki
-
-The heart of TiddlyWiki can be seen as an extensible representation transformation engine for text and images. Given the text of a tiddler and its associated ContentType, the engine can produce a rendering of the tiddler in a new ContentType. Furthermore, it can efficiently selectively update the rendering to track any changes in the tiddler or its dependents.
-
-The primary use of the engine is to convert raw `text/vnd.tiddlywiki` WikiText into a `text/html` or `text/plain` representation for display. The transclusion and templating features of WikiText allow the engine to also be used to generate TiddlyWiki HTML files from raw tiddlers.

editions/tw5.com/tiddlers/images/TiddlyWiki Architecture.svg.meta

@@ -0,0 +1,3 @@
+title: TiddlyWiki Architecture.svg
+type: image/svg+xml
+tags: picture