Proposal: modules for FirefoxOS

[David Flanagan]

Currently, we have only three modules related to FirefoxOS:

https://wiki.mozilla.org/Modules/All#Gaia
https://wiki.mozilla.org/Modules/All#Radio_Interface_Layer
https://wiki.mozilla.org/Modules/All#Widget_-_Gonk

This draft proposal (authored, at Brendan's request, by Tim Chien and
myself with valuable input from a number of others) elevates and renames
the Gaia module to make it the main FirefoxOS module, moves the Radio
Interface Layer and Widget-Gonk modules into this new toplevel FirefoxOS
module, and defines a number of new modules within it. In particular, it
defines a new Gaia module, and creates sub-modules for each of the built
in Gaia apps that will ship on FirefoxOS phones.

There are still some questions remaining about this proposal, in case
anyone wants to offer opinions here:

1) Should we favor single owners for the Gaia apps or multiple owners?

2) Do we need modules for mozbrowser, wifi, or gonk ports?

3) The current Gaia module has 14 peers, and this proposal does not
automatically copy those peers to the new Gaia module. This is largely
because the current list may be out of date. We could just add them now,
or allow the module owners to do that themselves.

The list of proposed modules follows.

David Flanagan

*Firefox OS*
*Owner: *Andreas Gal, Chris Jones
*Peer: *Jonas Sicking
Covers all the code necessary to build an Firefox OS phone, including
Gonk, etc.
*Source dir:*everything in https://github.com/mozilla-b2g

*_Submodules of Firefox OS:_*

*Gecko B2G runtime*
*Owner: *Vivien Nicolas, FabriceDesré, Chris Jones
Gecko runtime in the B2G stack and B2G Desktop. This includes immature
APIs like mozKeyboard while they still live under the b2g/ directory.
This module does not include APIs like telephony that have their own
gecko directory even though they are currently used only by Firefox OS.
*Source dir:*$GECKO_DIR/b2g

*Widget - Gonk*
See: https://wiki.mozilla.org/Modules/All#Widget_-_Gonk

*Radio Interface Layer*
See: https://wiki.mozilla.org/Modules/All#Radio_Interface_Layer

*Gaia*
*Owner: *Vivien Nicolas, Tim Chien
*Peers: *Fabrice Desré (build system), David Flanagan (shared/js),
Ismael González? (shared/style building blocks)
Gaia is a HTML5-based Phone UI for the Boot 2 Gecko Project. This module
covers all aspects of Gaia, including all of the apps that are not
sub-modules, the shared JavaScript and CSS code in shared/, the build
system and the interactions between apps.
*Source dir:*https://github.com/mozilla-b2g/gaia

*_Submodules of Gaia:_*

*System app*
*Owner: *Tim Chien, Vivien Nicholas
*Peers: *Alive Kuo, Etienne Segonzac
System app is the first HTML page and the first web app Gecko loads when
the phone boots up. It provides system UI and functionality of the
Firefox OS Phone, including window management, lock screen,
notification, cards view, attention screen, modal dialogs, application
update handling, application installation handling, etc.
*Source dir:*$GAIA_DIR/apps/system

*Browser app*
*Owner: *Ben Francis
*Peers: *Dale Harvey
Firefox Browser for Firefox OS. (Browser inception!)
*Source dir:*$GAIA_DIR/apps/browser

*Calendar app*
*Owner: *James Lal
*Peers:*
Calendar for Firefox OS
*Source dir:*$GAIA_DIR/apps/calendar

*Camera app*
*Owner: *Dale Harvey, David Flanagan
*Peers: *
Camera for Firefox OS, also secure camera panel in System app
*Source dir:*$GAIA_DIR/apps/camera

*Clock app*
*Owner: *Tim Chien
*Peers: *Ian Liu
Clock for Firefox OS, features alarm too
*Source dir:*$GAIA_DIR/apps/clock

*Communication app*
*Owner: *Etienne Segonzac (dialer), Alberto Pastore (contacts), Borja
Salguero (FTU), Jose Manuel Cantera Fonseca (Facebook Import)
*Peers: *
Communication for Firefox OS covers dialer, contacts, and first time
user experiences (FTU). It implements Facebook/GMail/live.com contact
import feature, and also performs various system config feature during FTU
*Source dir:*$GAIA_DIR/apps/communications

*Usage app*
*Owner: *Salvador de la Puente González
*Peers: *
Allow cost-sensitive users to track mobile data/wifi usage. It also
implements a widget in the System app.
*Source dir:*$GAIA_DIR/apps/costcontrol

*E-mail app*
*Owner: *Andrew Sutherland(libraries), Dominic Kuo (UI)
*Peers: *Jim Porter
E-mail for Firefox OS
*Source dir:*$GAIA_DIR/apps/email

*FM radio app*
*Owner: *Pin Zhang, Tim Chien
*Peers: *
FM radio for Firefox OS. Listen to FM radio on the Firefox OS phone.
*Source dir:*$GAIA_DIR/apps/fm

*Gallery app*
*Owner: *David Flanagan
*Peers: *Dale Harvey
Allow user to view/edit/manage image in the device media storage and
incoming source.
*Source dir:*$GAIA_DIR/apps/gallery

*Home screen app*
*Owner: *Vivien Nicholas
*Peers: *Evyatar Amitay (everything.me)
Implements the home screen of Firefox OS. Including Everything.me
functionalities, and some app management features.
*Source dir:*$GAIA_DIR/apps/homescreen

*Keyboard app*
*Owner: *Tim Chien, David Flanagan
*Peers: *Rudy Lu
Implements the virtual keyboard for Firefox OS phone, including word
suggestions (for alphabetical writing systems), Asian IMEs
(experimential, for Traditional Chinese, Simplified Chinese, and Japanese)
*Source dir:*$GAIA_DIR/apps/keyboard

*Music app*
*Owner: *Dominic Kuo
*Peers: *David Flanagan
Allow user to listen to the music in the device media storage and
incoming source.
*Source dir:*$GAIA_DIR/apps/music

*PDF Viewer app*
*Owner: pdf.js team, see **https://wiki.mozilla.org/Modules/All#PDF*
PDF Viewer for Firefox OS. Only launch-able through inline web activities.
*Source dir:*$GAIA_DIR/apps/pdfjs

*Settings app*
*Owner: *Fabien Cazenave, Evelyn Hung
*Peers: *Arthur Chen
Settings for Firefox OS. Allow users to configure various settings in
the OS.
*Source dir:*$GAIA_DIR/apps/settings

*Message app*
*Owner: *Borja Salguero, Steve Chung
*Peers: *
Message for Firefox OS. Handles SMS messages and soon MMS messages.
*Source dir:*$GAIA_DIR/apps/sms

*Video app*
*Owner: *David Flanagan
*Peers: *Dale Harvey
Allow user to watch the video in the device media storage and incoming
source.
*Source dir:*$GAIA_DIR/apps/video

[David Flanagan]

If you're viewing the FirefoxOS modules proposal in the google groups
archive, let me apologize for the messed up formatting.
Bold turned into asterisks and the mojibake is accented characters in
people's names.

David

[Justin Lebar]

> 2) Do we need modules for mozbrowser, wifi, or gonk ports?

I don't think mozbrowser needs to be its own module at this point.
(It's currently under DOM.) I own the code and I'm a DOM peer, and I
don't have any problem with other DOM peers reviewing changes to the
code if they feel comfortable doing so.

We can revisit this in the future if we want to make someone else a
mozbrowser peer but not a DOM peer. At this point it's not a lot of
code, so perhaps informal peership ("so and so can review mozbrowser
stuff") would be easiest. But we can cross that bridge later.

-Justin

> _______________________________________________
> governance mailing list
> gover...@lists.mozilla.org
> https://lists.mozilla.org/listinfo/governance

[Timothy Chien]

I would like to invite more people as the System app peers, given the fact the four people listed here doesn't cover all the knowledge of the code. Julien, Fabien both had touched various scripts in System app, and I would like to list them as peers too.

I am trying not to make everyone peer, since that will repeat the 14-peers scenario of the "Gaia" module. That said, owner/peers are always encouraged to invite the original author/proposer for the review process for a given script/feature.

BTW, I am not familiar with the governance mailing list process -- when will we consider the list is final?


Tim

[Gervase Markham]

On 15/03/13 00:04, David Flanagan wrote:
> 1) Should we favor single owners for the Gaia apps or multiple owners?

I think we shouldn't make a blanket determination, but I'd expect apps
to benefit from the unifying vision of a single decision-maker.

> 3) The current Gaia module has 14 peers, and this proposal does not
> automatically copy those peers to the new Gaia module. This is largely
> because the current list may be out of date. We could just add them now,
> or allow the module owners to do that themselves.

Module owners can add and remove peers at will, so it would seem best to
do that in this case.

Gerv

[Gervase Markham]

On 18/03/13 05:08, Timothy Chien wrote:
> BTW, I am not familiar with the governance mailing list process --
> when will we consider the list is final?

Officially, sign-off is with the members of the Module Ownership Module,
but given that you've developed this in consultation with Brendan, I
would expect that consensus here will lead to acceptance.

They are "official" when they've been added to the Modules page:
https://wiki.mozilla.org/Modules

(I would expect a new top-level category for Firefox OS to be created.)

Gerv

[David Flanagan]

Vivien Nicolas (owner of the Gaia module, who was on vacation when this
proposal was first sent) has proposed some minor changes, which I'm
pasting below. I will be formalizing these modules on the Wiki today.

David

> Some small changes:

>
> *_Submodules of Firefox OS:_*
>
> *Gecko B2G runtime*

> *Owner: *Vivien Nicolas, Fabrice Desr�, Chris Jones

> Gecko runtime in the B2G stack and B2G Desktop. This includes immature
> APIs like mozKeyboard while they still live under the b2g/ directory.
> This module does not include APIs like telephony that have their own
> gecko directory even though they are currently used only by Firefox OS.
> *Source dir:*$GECKO_DIR/b2g
>

> *Gaia*
> *Owner: *Vivien Nicolas, Tim Chien

> *Peers: *Alexandre Chameau (build system), David Flanagan (shared/js),
> Ismael Gonz�lez (shared/style building blocks), Fabien Cazenave
> (shared/style building blocks, shared/js/l10n.js)

> Gaia is a HTML5-based Phone UI for the Boot 2 Gecko Project. This module
> covers all aspects of Gaia, including all of the apps that are not
> sub-modules, the shared JavaScript and CSS code in shared/, the build
> system and the interactions between apps.
> *Source dir:*https://github.com/mozilla-b2g/gaia
>
> *_Submodules of Gaia:_*
>

> *System app*
> *Owner: *Tim Chien, Vivien Nicolas
> *Peers: *Alive Kuo, Etienne Segonzac, Fernando Jim�nez (payment.js,
> trusted_ui.js), Julien Wasjberg (updates)

> System app is the first HTML page and the first web app Gecko loads when
> the phone boots up. It provides system UI and functionality of the
> Firefox OS Phone, including window management, lock screen,
> notification, cards view, attention screen, modal dialogs, application
> update handling, application installation handling, etc.
> *Source dir:*$GAIA_DIR/apps/system
>

> *Browser app*
> *Owner: *Ben Francis
> *Peers: *Dale Harvey
> Firefox Browser for Firefox OS. (Browser inception!)
> *Source dir:*$GAIA_DIR/apps/browser
>
> *Calendar app*
> *Owner: *James Lal
> *Peers:*
> Calendar for Firefox OS
> *Source dir:*$GAIA_DIR/apps/calendar
>
> *Camera app*
> *Owner: *Dale Harvey, David Flanagan
> *Peers: *
> Camera for Firefox OS, also secure camera panel in System app
> *Source dir:*$GAIA_DIR/apps/camera
>
> *Clock app*
> *Owner: *Tim Chien
> *Peers: *Ian Liu
> Clock for Firefox OS, features alarm too
> *Source dir:*$GAIA_DIR/apps/clock
>

> *Communications app*
> *Owner: *Etienne Segonzac (dialer), Alberto Pastor (contacts),
> Francisco Jordano (ftu), Jose Manuel Cantera Fonseca (Facebook Import)
> *Peers: *Borja Salguero (ftu), Jose Manuel Cantera Fonseca (contacts),
> Francisco Jordano (contacts)

> Communication for Firefox OS covers dialer, contacts, and first time
> user experiences (FTU). It implements Facebook/GMail/live.com contact
> import feature, and also performs various system config feature during
> FTU
> *Source dir:*$GAIA_DIR/apps/communications
>
> *Usage app*

> *Owner: *Salvador de la Puente Gonz�lez
> *Peers: *Vivien Nicolas

> Allow cost-sensitive users to track mobile data/wifi usage. It also
> implements a widget in the System app.
> *Source dir:*$GAIA_DIR/apps/costcontrol
>
> *E-mail app*
> *Owner: *Andrew Sutherland(libraries), Dominic Kuo (UI)
> *Peers: *Jim Porter
> E-mail for Firefox OS
> *Source dir:*$GAIA_DIR/apps/email
>
> *FM radio app*
> *Owner: *Pin Zhang, Tim Chien

> *Peers: *Vivien Nicolas

> FM radio for Firefox OS. Listen to FM radio on the Firefox OS phone.
> *Source dir:*$GAIA_DIR/apps/fm
>
> *Gallery app*
> *Owner: *David Flanagan
> *Peers: *Dale Harvey
> Allow user to view/edit/manage image in the device media storage and
> incoming source.
> *Source dir:*$GAIA_DIR/apps/gallery
>
> *Home screen app*

> *Owner: *Christian Rodriguez de la Cruz, Vivien Nicolas

> *Peers: *Evyatar Amitay (everything.me)
> Implements the home screen of Firefox OS. Including Everything.me
> functionalities, and some app management features.
> *Source dir:*$GAIA_DIR/apps/homescreen
>
> *Keyboard app*
> *Owner: *Tim Chien, David Flanagan

> *Peers: *Rudy Lu, Christoph (predictive text)

> Implements the virtual keyboard for Firefox OS phone, including word
> suggestions (for alphabetical writing systems), Asian IMEs
> (experimential, for Traditional Chinese, Simplified Chinese, and
> Japanese)
> *Source dir:*$GAIA_DIR/apps/keyboard
>
> *Music app*
> *Owner: *Dominic Kuo
> *Peers: *David Flanagan
> Allow user to listen to the music in the device media storage and
> incoming source.
> *Source dir:*$GAIA_DIR/apps/music
>
> *PDF Viewer app*
> *Owner: pdf.js team, see **https://wiki.mozilla.org/Modules/All#PDF*
> PDF Viewer for Firefox OS. Only launch-able through inline web
> activities.
> *Source dir:*$GAIA_DIR/apps/pdfjs
>
> *Settings app*
> *Owner: *Fabien Cazenave, Evelyn Hung

> *Peers: *Arthur Chen, Fernando Rodriguez Sela (STK), Vivien Nicolas

> Settings for Firefox OS. Allow users to configure various settings in
> the OS.
> *Source dir:*$GAIA_DIR/apps/settings
>
> *Message app*

> *Owner: *Francisco Jordano
> *Peers: *Borja Salguero, Julien Wasjberg, Steve Chung

[David Flanagan]

The wiki has been updated. Please welcome our new FirefoxOS modules:
https://wiki.mozilla.org/Modules/FirefoxOS

As part of this change, the Widget - Gonk and Radio Interface Layer
modules have moved from Core into FirefoxOS. I have also modified the
old Modules:Boot2Gecko page to link to this new FirefoxOS page.

David

[jame...@gmail.com]

I suggest we add Keven Kuo to the Gonk owner to off load mwu. We have a team in Taipei working on Gonk and system related stuffs. We definitely need to take care of multiple chipsets, phone models, builds that all result in changes in Gonk at Github more efficiently.

Personally, I don't think we are efficient enough at the moment, and we're seeing more and more requests here. Having one more capable owner who can work closely with mwu and help him when he's not available will greatly improve the Gonk module.

--
James Ho

David Flanagan於 2013年3月29日星期五UTC-7下午1時32分41秒寫道：

[jame...@gmail.com]

I suggest we add Keven Kuo to the Gonk owner to off load mwu. We have a team in Taipei working on Gonk and system related stuffs. We definitely need to take care of multiple chipsets, phone models, builds that all result in changes in Gonk at Github more efficiently.

Personally, I don't think we are efficient enough at the moment, and we're seeing more and more requests here. Having one more capable owner who can work closely with mwu and help him when he's not available will greatly improve the Gonk module.

--
James Ho

David Flanagan於 2013年3月29日星期五UTC-7下午1時32分41秒寫道：

[Mike Connor]

I think that what you're describing fits the idea of a module peer more than a second owner. If a module owner needs help to keep up reviews (and velocity) it's their responsibility identify/develop peers to assist their work. cc-ing mwu to make sure he's aware of the concern here, as it sounds like there's a problem that needs solving.

-- Mike

[Michael Wu]

Hi James,

I agree that we're not being efficient enough on the Gonk side, but I suspect that is largely an issue of communications rather than not having enough bandwidth. We do need more Gonk peers, but more so to increase the bus factor.

Thanks for raising the issue though - we should speak in more detail about this.

-Michael Wu

[Blake Kaplan]

David Flanagan <dfla...@mozilla.com> wrote:
> 2) Do we need modules for mozbrowser, wifi, or gonk ports?

Sorry that I saw this late. I think it makes sense to have a module for wifi
at this point. The code lives under dom/wifi/* (at the moment, though we could
move it if people want) but the current owner (Vincent Chang) is not a DOM
peer, nor is the code like any other DOM code in the tree.
--
Blake Kaplan

[Doug Turner]

Also note that there is some wifi scanning code in netwerk/wifi that I
claim ownership of... but would *love* to see someone merge the two systems.

[Doug Turner]

On 4/2/13 2:30 PM, Blake Kaplan wrote: