On Wed, Mar 31, 2010 at 3:59 AM, Bjorn Tillenius <[email protected]> wrote: > Hi guys, > > so, it's time for the Technical Architect team to tackle its first task. > Create the Launchpad Architectural Vision. > > First of all, what is it? It's aimed to be documents that describe the > different parts of Launchpad. It will explain how Launchpad works, which > moving parts are involved, and how it will fit together. It will also > explain the various sub-systems, and explain how to do various things in > Launchpad code. For example, how do I send and receive e-mail? How do I > add an html page? How do I write a script? Etc.
A summary of the moving parts and how they fit together is definitely something that is missing currently, however, there is a lot of existing documentation for the various sub-systems. Are we just trying to point the reader to that documentation, trying to explain things more tersely, or planning to move some of that existing documentation into the architect-vision directory? I really think we should avoid duplicating documentation. If existing doc tests are too verbose, we can break them into pieces. -Edwin _______________________________________________ Mailing list: https://launchpad.net/~launchpad-dev Post to : [email protected] Unsubscribe : https://launchpad.net/~launchpad-dev More help : https://help.launchpad.net/ListHelp
