← Back to team overview

launchpad-dev team mailing list archive

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