View source for Firefox OS/Comms/Dialer

[[File:Dialer_142.png|frameless|left|Gaia Dialer App Icon]]
The '''dialer''' is a component of [[Gaia]], which in turn is the front-end for [[FirefoxOS|Firefox OS]]. The dialer comprises all of the front-end code for making and receiving calls, including the callscreen, which is a separate app. The dialer team is organized under the umbrella of the [[FirefoxOS/Comms/|communications apps]] team.

In addition, the dialer team is responsible for emergency calling, CDMA, USSD/MMI, DTMF tones, integration with other communications apps, and dealing with partner requirements.
<br><br><br><br>

=Meetings/Team Communication=

==IRC==
We mostly use IRC. We're available on #fxos-dialer, and #fxos-comms. 

==Daily Standup Meetings==
The daily standup meeting is composed of two parts: the first is async, and happens sometime before the sync meeting. Full-time dialer team members should write the progress that they've made in the last day on the [https://etherpad.mozilla.org/fxos-dialer-scrum dialer scrum Etherpad]. Part-time members and observers can optionally do the same. Additional instructions on what to write are in that section itself.

The second part of the meeting is sync, and happens over IRC at 2:30 pm GMT (10:30 am EST, 4:30 pm CEST) in the #fxos-dialer [[IRC]] channel. Here, participants should only discuss major things, blocking issues, and questions that they have for others. The goal is to keep this meeting 10 minutes long or less.

==Comms Apps Meetings==
Dialer team members participate in the thrice-weekly comms apps meetings and give updates here. There are no established rules for this, but typically only European members participate, due to timezone differences. These meetings are expected to be killed off soon.

=Sprints=

==Past Sprints==
*[[FirefoxOS/Comms/Dialer/Sprint/v2.0-S6|Sprint v2.0-S6, Jul 7 - Jul 21]]
*[[FirefoxOS/Comms/Dialer/Sprint/1|Sprint 1, Jun 23 - Jul 4]]
** Different naming system; this was the first sprint that we documented. It is now retroactively named v2.0-S5.

==Sprint Planning==
Sprint planning happens every 2 weeks on Mondays, at 1:30 pm GMT (9:30 am EST, 3:30 pm CEST) in Joe Cheng's Vidyo room.

===Retrospective===
We begin sprint planning with a retrospective. This is the place where we change things. Everybody must think ahead of time about what was good and bad during the last sprint. This could be anything, and can be entirely opinion. Participants should also think of any questions that they have.

During the meeting, everybody dumps their thoughts on the [https://etherpad.mozilla.org/fxos-dialer-retrospective sprint planning retrospective Etherpad], and then we take some time to review them. Ideally, all bad things and questions end up having action items. 

===Estimates===
We have 25 points of velocity every sprint based on 8 team members; 2 part-time. We make estimates as to how long features will take to complete in days, but we don't estimate bugs (or we assume they're 1 point).

Between 50% and 75% (depending on the moment in the release cycle) of the velocity is used for blockers. The rest of the velocity is kept for new blockers appearing during the sprint.

We take the list of bugs in the order of priority, and estimate them together. Estimates are identified by: <pre>[planned-sprint c=X]</pre> tag, where X is the estimated number of days, or "cost".

===Priorities===
Currently, the rough priority order is: 1.3T+ > 1.4+ > 2.0+ > 2.1+ > features > nice-to-have >= dialer-most-wanted. We can have a look at the nominations (2.1?, etc) too. nice-to-have are provided by the EPM, whereas dialer-most-wanted are decided internally within the dialer team.

===Assigning===
When we reach the available velocity, we stop. We try to take some tech debt bugs or long term projects (at least 1 per sprint would be nice), identified by blocking the dialer-most-wanted bug, {{bug|1036516}}.

===Whiteboard Tags===
* [planned-sprint] - Indicates that we planned to take this at the beginning of a sprint.
* [in-sprint=vXXX] - (e.g. [in-sprint=v2.0-S5]) Indicates that we took this in a previous sprint and had to push it to a later one.

==Current Sprint (v2.1-S1)==
<big>[[FirefoxOS/Comms/Dialer/Sprint/v2.1-S1]]</big>
{{:FirefoxOS/Comms/Dialer/Sprint/v2.1-S1}}

=Bugs=

====Blockers====
* [https://bugzilla.mozilla.org/buglist.cgi?f1=cf_blocking_b2g&o1=substring&v1=%2B&resolution=---&component=Gaia%3A%3ADialer Bugzilla query]
* Note that these are each prioritized by EPM, not internally within the dialer team.
<bugzilla>
{
  "component": "Gaia::Dialer",
  "cf_blocking_b2g": "+",
  "cf_blocking_b2g_type": "contains",
  "resolution": "---",
  "include_fields": "id, assigned_to, summary, cf_blocking_b2g, cf_feature_b2g, whiteboard, status, resolution"
}
</bugzilla>

====Blockers Without an Assignee====
<bugzilla>
{
  "component": "Gaia::Dialer",
  "cf_blocking_b2g": "+",
  "cf_blocking_b2g_type": "contains",
  "resolution": "---",
  "assigned_to": "nobody@mozilla.org",
  "include_fields": "id, assigned_to, summary, cf_blocking_b2g, cf_feature_b2g, whiteboard, status, resolution"
}
</bugzilla>

====Features====
* [https://bugzilla.mozilla.org/buglist.cgi?f1=cf_feature_b2g&o1=notsubstring&v1=---&resolution=---&component=Gaia%3A%3ADialer Bugzilla query]
* Note that these are each prioritized by EPM, not internally within the dialer team.
<bugzilla>
{
  "component": "Gaia::Dialer",
  "cf_feature_b2g": "2.",
  "cf_feature_b2g_type": "contains",
  "resolution": "---",
  "include_fields": "id, assigned_to, summary, cf_blocking_b2g, cf_feature_b2g, whiteboard, status, resolution"
}
</bugzilla>

====Nice-to-have====
* [https://bugzilla.mozilla.org/buglist.cgi?status_whiteboard=priority&status_whiteboard_type=allwordssubstr&resolution=---&component=Gaia%3A%3ADialer Bugzilla query]
* Note that these are each prioritized by EPM, not internally within the dialer team.
<bugzilla>
{
  "component": "Gaia::Dialer",
  "whiteboard": "[priority]",
  "whiteboard_type": "contains",
  "resolution": "---",
  "include_fields": "id, assigned_to, summary, cf_blocking_b2g, cf_feature_b2g, whiteboard, status, resolution"
}
</bugzilla>

====Dialer-most-wanted====
* [https://bugzilla.mozilla.org/showdependencytree.cgi?id=dialer-most-wanted&hide_resolved=1 Bugzilla query]
<bugzilla>
{
  "component": "Gaia::Dialer",
  "blocks": "1036516",
  "resolution": "---",
  "include_fields": "id, assigned_to, summary, cf_blocking_b2g, cf_feature_b2g, whiteboard, status, resolution"
}
</bugzilla>

=Reference Materials=
==API/Programming Documentation==
Actual code documentation should go on the [http://developer.mozilla.org Mozilla Developer Network]. Currently, the documentation is very shallow. Please consider contributing to it!

==Feature/Subcomponent Documentation==
* [[FirefoxOS/Comms/Dialer/DSDS-DSDA|DSDS/DSDA]]
* [[FirefoxOS/Comms/Dialer/USSD-MMI|USSD/MMI]]
* [[FirefoxOS/Comms/Dialer/CDMA|CDMA]]
* [[FirefoxOS/Comms/Dialer/DTMF Tones|DTMF Tones]]
* [[FirefoxOS/Comms/Dialer/WAP-Push|WAP Push]] (not actually really dialer)

==UX Specifications==
====v2.1====
* Dialer: https://mozilla.app.box.com/s/44utizl9oz4eupyu3fuu/1/2184700727

====v2.0====
* Dialer: https://mozilla.app.box.com/s/44utizl9oz4eupyu3fuu/1/1803746785
====v1.4====
* Dialer: https://mozilla.app.box.com/s/44utizl9oz4eupyu3fuu/1/1464669995
* DSDS: https://mozilla.app.box.com/s/44utizl9oz4eupyu3fuu/1/1425004300
====v1.3====
* Dialer: https://mozilla.app.box.com/s/44utizl9oz4eupyu3fuu/1/1260971310
* DSDS: https://mozilla.app.box.com/s/44utizl9oz4eupyu3fuu/1/1206603879

==Development==
* [https://github.com/mozilla-b2g/gaia/tree/master/apps/communications/dialer Dialer source code on GitHub]
* [https://github.com/mozilla-b2g/gaia/tree/master/apps/callscreen Callscreen source code on GitHub]

=Team=
==Manager==
* [mailto:dscravaglieri@mozilla.com David "scravag" Scravaglieri] - Senior Engineering Manager, Communications
==Developers==
* [mailto:aricaud@mozilla.com Anthony "Rik" Ricaud] - Core Developer and Module Peer, Mozilla
* [mailto:dsherk@mozilla.com Doug "drs" Sherk] - Core Developer, Mozilla
* [mailto:thills@mozilla.com Tamara "thills" Hills] - Core Developer, Mozilla
* [mailto:esegonzac@mozilla.com Etienne "etienne_s" Segonzac] - Developer and Module Owner, Mozilla
* [mailto:gsvelto@mozilla.com Gabriele "gsvelto" Svelto] - Developer, Mozilla
* [mailto:gtorodelvalle@gmail.com Germán "gtorodelvalle" Toro del Valle] - Developer, Telefonica
* [mailto:pacorampas@gmail.com Paco "paco" Rampas] - Developer, Telefonica
* [mailto:david.garciaparedes@telefonica.com David "davidg" Garcia] - Developer, Telefonica

==User Experience==
* [mailto:cawang@mozilla.com Carrie "CarrieW" Wang] - UX Designer, Mozilla
==Visual Design==
* [mailto:chuang@mozilla.com Carol Huang] - Visual Designer, Mozilla

=Long-Term Project Ideas=
* {{Bug|1035153}} - Prototype dialer without tab bar.
* {{Bug|1039131}} - Improve stylesheet docs, simplicity, and organization.
** {{Bug|1039130}} - Use StyleDocco documentation generator for stylesheets.
* General redesign and refactors (a la Haidification).
* Better support for testing emergency calls without accidentally placing them.
* Moving more towards using HTML template fragments for more realistic testing.
* Clean up keypad and DMTF tones code (blocked partially on platform WebAudio work)
* Clean up USSD/MMI code, add multi-SIM support.
* Have a platform for automated integration tests (mulet? emulator? something else?)
* Testing CDMA in regions that don't use it, perhaps using the emulator.
* Improve emulator use and documentation.
* Separate communications apps into different apps.
* Improve Kanban and our dashboard tools.
* Move call log to a DataStore.
** This will help memory consumption by not opening the Dialer app after a call.
* <s>{{Bug|1039594}} - Use FontSizeUtils in shared instead of our own FontSizeManager</s>

=Ideas for Improvement=
* Do video demos of important new features.
* Discuss vision for the future of the dialer, including the app itself, the team organization, and how we work.
* Improve communication with VD and UX, e.g. set up progress-based meetings.
* Improve the way we split up bugs and use metabugs to make things easier for UX and VD people.
* Integrate Kanban more into our workflow.
* Get more contributors engaged.

=Restructuring Progress=
{{:FirefoxOS/Comms/Dialer/Restructure/Proposal}}