launchpad-dev team mailing list archive
-
launchpad-dev team
-
Mailing list archive
-
Message #03123
Re: [tech] Help creating the Architectural Vision!
On Wed, 2010-03-31 at 12:59 +0300, Bjorn Tillenius 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.
>
> An important goal of the Vision is to avoid people doing duplicate work,
> so it should document that canonical way of doing various things in
> Launchpad. If you implement a new feature, and for example don't know
> how the implementation should look like, the Vision should be the place
> to look, to see what existing code you can re-use. That's why I want to
> focus on things that are shared (or supposed to be shared) across
> applications to start with.
>
> I need your help, though! It's a lot of work, and some of you have a lot
> of expertise of certain areas of Launchpad. I need help figuring out
> what should be included in the Vision. I also need volunteers describing
> the different parts. For example, someone from the Code team would be a
> good candidate writing about the job system. Although, not necessarily.
> If you're interested in how a certain part works, trying to document it
> is a great way of learning! Also, you don't have to volunteer yourself,
> finding other volunteers is also acceptable :)
>
> These are the things I thought of so far that should be included:
>
> * Overview of Launchpad and its moving parts
> * job system
> * e-mail (sending/receiving)
> * Database garbage collection (garbo)
> * expose API methods/attributes
> * Web app
> * Browser views
> * TAL formatters
* Breadcrumbs
* canonical_url
* AJAX
> * Librarian
> * Comments
> * DB Schema
Master/slave DBs and when/how to use them
Vocabularies, maybe?
> * LaunchpadScript
> * LaunchpadCronScript
> * Security policy
> * SSH server
>
> * Code layout (what's in lp.code/lp.services/lp.registry/etc.)
> * Testing
> * Where to place tests
> * How to write tests
> * Layers
>
> Anything missing?
>
--
Guilherme Salgado <salgado@xxxxxxxxxxxxx>
Attachment:
signature.asc
Description: This is a digitally signed message part
Follow ups
References