Proposal: New wiki layout

James Blackwell jblack at merconline.com
Sun Jan 15 22:01:12 GMT 2006


We have plenty of documentation up on the wiki. This is good. The
new documentation has been added as an evolutionary process, which is bad.
I therefore propose a new layout for the wiki that will not only allow
everything already known to be found, but to leave room for new stuff as
well.


               Conceptual         | Installation---------->| Mini Tutorial
           ,>| descriptions.      | Single Developer     ,>| BZREMAIL   
	   |                      | Small Teams          |
           |        |FAQ          | Fully Decentralized  ,
           |        |Glossary     | Bzr Style           / 
What is it-'      ,-|Notes        | PQM Style--------@ / @-------------.
Documentation ---'  |Tutorials--->| Fully Centralized /                 \
Installation-----.  |Who uses Bzr                    /                   '
Downloading------.`---------------------------------'                    |
Plugins--------.  `----------------------------------| Downloads Page    |
Development--.  `.                                   | 3rd Party Tools-. |
Support-.     '   `>|Current Plugin Registry Page      .---------------' |
Historic \    |     |Making your own Plugin------,    /                  |
     |   |    |                                 /   .'                   |
     |   |    |    | Latest crack              /    `->|PQM--------------'
     |   |    `--->| PEP8                     @        |Supermirror
     |   |         | How to submit patches >-----,          /\
     |   |         | Writing tests          @   /           ||
     |   |         | Writing Plugins<------'   /         From all over
     |   |                                    /          tutorial
     |   |  ,--------------------------------' 
     |   |  `---> | Mailing lists
     |   `------> | Irc channels
     |            | Bug Tracker
     |            | Upcoming Events
     |
     `---| Link to old Bazaar-1 Pages

 * I imagine Conceptual descriptions to be the X number of factoids that
   one needs to understand in order to understand Bazaar-NG. I see short
   paragraph format

 * Most of the content for this already exists on the current pages, though
   a shuffling a bit of it from here to there would be good.

 * Eventually BzrGlossary gets broken into individual pages, which gets 
   camelcaselinked. We need better descriptions in the glossary first and 
   agreed upon camelcasing.

 * Concepts are probably actually glossary items for which terms just need
   to be devised. We've generally named things well, concepts not so well.

 * Plugins should be on the downloading page, pointing at the plugins
   download page which is not representable in this graph. Another example
   is BugTracker, which should be on not just support, but development as
   well.

 * I can imagine many other useful pages that would fit well within this
   layout. For example, information on packaging bzr would go well under
   development. 

-- 
James Blackwell's home :  http://jblack.linuxguru.net
Gnupg 06357400   F-print AAE4 8C76 58DA 5902 761D  247A 8A55 DA73 0635 7400
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060115/22f4ef61/attachment.pgp 


More information about the bazaar mailing list