Revision 647023 of Developer phone guide documentation plan

  • Revision slug: MDN/Plans/Developer_phone_guide
  • Revision title: Developer phone guide documentation plan
  • Revision id: 647023
  • Created:
  • Creator: Sheppy
  • Is current revision? No
  • Comment

Revision Content

Every day on mailing lists such as dev-b2g, we get a huge number of e-mails asking for support information about B2G/Firefox OS, installing/updating it on various devices, unbricking phones, carrier and device-specific quirks, etc. This requires a lot of effort to keep the developer community happy, and it would be really useful to put together a series of pages that would hopefully cover all the different problems developers are coming up against when trying to update the B2G software on all the different available devices that are capable of running Firefox OS.

We do have an initial guide, but it was never completed, and has not been updated for more recent devices.

But this currently covers only the Geeksphone and ZTE OPEN. There are a number of other devices not covered here, and a possible number of other carrier/device/B2G version quirks that ought to be covered. The aim of this project is to scope out, collect and publish all information about the various Mozilla-sponsorded Firefox OS developer phones, in an easy to navigate format.

Team

The project will be handled primarily by:

{{UserLink("chrisdavidmills")}}
Primary writer.

Other MDN contributors may of course participate as well!

Goals

  • Provide a list of all the phones Mozilla has provided as "developer phones," including:
    • Hardware specifications
    • Carrier support
    • How to buy or obtain the device (also whether or not it's still available at all)
    • How to update/flash the device
    • How to build the OS from scratch for the device, including details about device-specific quirks that vary from the primary Building and installing Firefox OS guide.
    • How to modify and hack on the device's OS
    • How to unbrick the device
    • Any other particular quirks or features specific to the device
  • Devices that need to be covered, at a minimum
    • Geeksphone Peak
    • Geeksphone Keon
    • ZTE OPEN
    • Others?

Target milestones

This information is not yet available.

User stories

This information is not yet available.

Documents needed

The lists here detail specific types of content that need to be produced, as well as precise pages that we know need to be produced or updated.

Types of pages

The following types of pages will need to be produced:

  • Landing pages
  • Guides/tutorials

Landing pages

The following landing page will need to be produced:

  • A page primarily consisting of a table of all "developer phone" devices that are or have been available, with information about them provided in some form.

User guides

The following user guide pages will be needed, as sub-pages of the table:

  • For each phone, provide the details as outlined in {{anch("Goals")}}.

Existing content

The article Developer phone guide exists but is about a very very old device, and does not cover any newer devices. This page should be replaced with the new landing page listing all available developer phone models.

Other notes

People to talk to for information

  • Ivan Tsay, Jack Guo from the Engineering side of things, possibly even Andreas Gal if things need to be escalated
  • Mark Coggins, Rob Nyman, Christie Koehler, Havi Hoffman from the evangelism side. They have a lot of knowledge about different devices, and the developer program stack overflow support idea might help with all this.
  • dev-b2g list for more technical details

Revision Source

<p>Every day on mailing lists such as dev-b2g, we get a huge number of e-mails asking for support information about B2G/Firefox OS, installing/updating it on various devices, unbricking phones, carrier and device-specific quirks, etc. This requires a lot of effort to keep the developer community happy, and it would be really useful to put together a series of pages that would hopefully cover all the different problems developers are coming up against when trying to update the B2G software on all the different available devices that are capable of running Firefox OS.</p>
<p>We do have an <a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide">initial guide</a>, but it was never completed, and has not been updated for more recent devices.</p>
<p>But this currently covers only the Geeksphone and ZTE OPEN. There are a number of other devices not covered here, and a possible number of other carrier/device/B2G version quirks that ought to be covered. <span class="seoSummary">The aim of this project is to scope out, collect and publish all information about the various Mozilla-sponsorded Firefox OS developer phones, in an easy to navigate format.</span></p>
<h2 id="Team">Team</h2>
<p>The project will be handled primarily by:</p>
<dl>
 <dt>
  {{UserLink("chrisdavidmills")}}</dt>
 <dd>
  Primary writer.</dd>
</dl>
<p>Other MDN contributors may of course participate as well!</p>
<h2 id="Goals">Goals</h2>
<ul>
 <li>Provide a list of all the phones Mozilla has provided as "developer phones," including:
  <ul>
   <li>Hardware specifications</li>
   <li>Carrier support</li>
   <li>How to buy or obtain the device (also whether or not it's still available at all)</li>
   <li>How to update/flash the device</li>
   <li>How to build the OS from scratch for the device, including details about device-specific quirks that vary from the primary <a href="/en-US/Firefox_OS/Building_and_installing_Firefox_OS">Building and installing Firefox OS</a> guide.</li>
   <li>How to modify and hack on the device's OS</li>
   <li>How to unbrick the device</li>
   <li>Any other particular quirks or features specific to the device</li>
  </ul>
 </li>
 <li>Devices that need to be covered, at a minimum
  <ul>
   <li>Geeksphone Peak</li>
   <li>Geeksphone Keon</li>
   <li>ZTE OPEN</li>
   <li>Others?</li>
  </ul>
 </li>
</ul>
<h2 id="Target_milestones">Target milestones</h2>
<p><em>This information is not yet available.</em></p>
<h2 id="User_stories">User stories</h2>
<p><em>This information is not yet available.</em></p>
<h2 id="Documents_needed">Documents needed</h2>
<p>The lists here detail specific types of content that need to be produced, as well as precise pages that we know need to be produced or updated.</p>
<h3 id="Types_of_pages">Types of pages</h3>
<p>The following types of pages will need to be produced:</p>
<ul>
 <li>Landing pages</li>
 <li>Guides/tutorials</li>
</ul>
<h3 id="Landing_pages">Landing pages</h3>
<p>The following landing page will need to be produced:</p>
<ul>
 <li>A page primarily consisting of a table of all "developer phone" devices that are or have been available, with information about them provided in some form.</li>
</ul>
<h3 id="User_guides">User guides</h3>
<p>The following user guide pages will be needed, as sub-pages of the table:</p>
<ul>
 <li>For each phone, provide the details as outlined in {{anch("Goals")}}.</li>
</ul>
<h2 id="Existing_content">Existing content</h2>
<p>The article <a href="/en-US/Firefox_OS/Developer_phone_guide">Developer phone guide</a> exists but is about a very very old device, and does not cover any newer devices. This page should be replaced with the new landing page listing all available developer phone models.</p>
<h2 id="Other_notes">Other notes</h2>
<h3 id="People_to_talk_to_for_information">People to talk to for information</h3>
<ul>
 <li>Ivan Tsay, Jack Guo from the Engineering side of things, possibly even Andreas Gal if things need to be escalated</li>
 <li>Mark Coggins, Rob Nyman, Christie Koehler, Havi Hoffman from the evangelism side. They have a lot of knowledge about different devices, and the developer program stack overflow support idea might help with all this.</li>
 <li>dev-b2g list for more technical details</li>
</ul>
Revert to this revision