Apps/Developers: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
m (→‎Implementation bugs: use right query for bugzilla list)
 
(38 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__
This page contains all of the important details for the '''Apps Developers''' project (marketplace.mozilla.org/developers).
This page contains all of the important details for the '''Apps Developers''' project (marketplace.mozilla.org/developers).


Line 11: Line 10:
* Code Repo: [https://github.com/mozilla/zamboni/tree/master/mkt/ecosystem Zamboni/mkt]
* Code Repo: [https://github.com/mozilla/zamboni/tree/master/mkt/ecosystem Zamboni/mkt]
* Code: Django (part of Zamboni = AMO/Marketplace)
* Code: Django (part of Zamboni = AMO/Marketplace)
* Product Owner: Daniel Buchner
* Product Owner: Fred Wenzel
* Dev Team: Arron Schaar (dev)
* Dev Team: Arron Schaar (dev), Jen Fong (dev)
* IRC Channel: [irc://irc.mozilla.org:6697/devecosystem #devecosystem on irc.mozilla.org]
* IRC Channel: [irc://irc.mozilla.org:6697/devecosystem #devecosystem on irc.mozilla.org]


Line 18: Line 17:
* Phase 2. (see below)
* Phase 2. (see below)
* Target release date: Q3 2012 [https://intranet.mozilla.org/2012Q3Goals#Web_Development goal]
* Target release date: Q3 2012 [https://intranet.mozilla.org/2012Q3Goals#Web_Development goal]
== Developer Hub vs. MDN ==
To avoid confusion and duplication, the distinction between the developer hub and MDN is important:
Devhub:
* provides tutorials and end-to-end guide from ideation to publishing/maintaining an app
* outlines platform capabilities
* links to resources
* provides links to download key developer products, like development templates, web components
* has examples and excerpts
* limited scope to "interesting aspects" of the apps stack
* does '''not''' go into nitty-gritty details of APIs and all conceivable tools
MDN:
* Canonical source of all docs content, even the content displayed as part of the dev hub (devhub pulls specific data from MDN)
* has in-detail API documentation, for all relevant APIs
* covers the entire web stack


= Development Phases =
= Development Phases =
Line 66: Line 82:
* https://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/
* https://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/


== Landing Page ==  
=== Landing Page ===
Informational landing page(s) outlining the dev process for web apps.
Informational landing page(s) outlining the dev process for web apps.


Line 114: Line 130:
marketplace.m.o/developers should be a one-stop destination for developers who want to develop open web apps.
marketplace.m.o/developers should be a one-stop destination for developers who want to develop open web apps.


=== Developer Hub vs. MDN ===
=== DevHub Structure ===
To avoid confusion and duplication, the distinction between the developer hub and MDN is important:
==== Priorities ====
* P1/P2 content priorities: https://etherpad.mozilla.org/devhub
 
==== Whiteboard Drafts ====
* <del>[http://people.mozilla.com/~fwenzel/files/debhub/wb-frontpage.jpg Front page]</del>
** [http://people.mozilla.com/~fwenzel/files/debhub/wb-frontpage-0816.jpg Front page], revision 8/16
* <del>[http://people.mozilla.com/~fwenzel/files/debhub/wb-devs.jpg Developers]</del>
** [http://people.mozilla.com/~fwenzel/files/debhub/wb-devs-0816.jpg Developers], revision 8/16
* [http://people.mozilla.com/~fwenzel/files/debhub/wb-partners.jpg Partners]
* [http://people.mozilla.com/~fwenzel/files/debhub/wb-support.jpg Support]
 
==== Nav Structure ====
cf. whiteboard drafts for sketches
 
* Global structure, always visible:
** Front page (placeholder. "Developer Hub", perhaps?)
** Developers
** Partners
** Support
 
* Front page sections:
** Platform pitch (borrow from phase 1 content)
** Developers
** Partners
** Support
 
* Developers page:
** Get started
*** HTML5 etc. (technology basics)
*** Manifests etc (parts of an open web app)
*** <span style="opacity:.5">Application types / security model (TBD)</span> (not in August unless we have content already? Mark?)
*** tutorials and examples
** Design it
*** (subsections as developed by [[Apps/Design]] project)
** Code it
*** Firefox Dev Tools (Nightly+responsive mode)
*** <span style="opacity:.5"><del>emulators</del> test environments</span> (not in August)
*** templates (mortar)
*** web components (x-tags)
** Publish it
*** Hosting / packaging
*** <span style="opacity:.5">Payments '''(Wil?)''' ''(not in August)''</span>
*** <span style="opacity:.5">Metrics '''(Wil?)''' ''(not in August)''</span>
*** <span style="opacity:.5">Updates ''(not in August?)''</span>
*** Marketplace submission
 
* Partners page:
** Reach
*** Firefox OS - Emerging Market/New smartphone users
** Open
*** Based on standard web technologies (limiting/eliminating fragmentation)
*** Capturing a native like experience using standard web technologies
** Choice
*** Direct User-Developer relationship
*** Light Approval Process
*** No need to resubmit apps for updated content
 
* Support page:
** Landing page: Where to find help about open web apps and the marketplace


Devhub:
=== Implementation bugs ===
* provides tutorials and end-to-end guide from ideation to publishing/maintaining an app
Tracking bug: {{bug|782374}}
* outlines platform capabilities
* links to resources
* provides links to download key developer products, like development templates, web components
* has examples and excerpts
* limited scope to "interesting aspects" of the apps stack
* does '''not''' go into nitty-gritty details of APIs and all conceivable tools


MDN:
<bugzilla>
* Canonical source of all docs content, even the content displayed as part of the dev hub (devhub pulls specific data from MDN)
{
* has in-detail API documentation, for all relevant APIs
  "product": "Marketplace",
* covers the entire web stack
  "component": "Developer Pages",
  "blocks": "782374",
  "resolution": "---"
}
</bugzilla>


=== Content ===
=== Content pieces ===
==== Existing/in-progress content ====
==== Existing/in-progress content ====
* [[Apps/Mortar|open web apps development templates]] (mortar, webgamestub)
* [[Apps/Mortar|open web apps development templates]] (mortar - ''jlongster'', webgamestub - ''dmose'')
* [[Apps/x-tag|web components]] (x-tags)
* [[Apps/x-tag|web components]] (x-tags - ''dbuc'')
* tutorials and end-to-end "walkthrough"
* tutorials and end-to-end "walkthrough"
** ''Outline and resources above (stage 1).''
** ''Outline and resources above (stage 1).''
Line 140: Line 212:
** [https://github.com/jlongster/weatherme/blob/master/tutorial.md Introductory tutorial for mortar] (and example app) on github, to move to MDN.
** [https://github.com/jlongster/weatherme/blob/master/tutorial.md Introductory tutorial for mortar] (and example app) on github, to move to MDN.
* [[Apps/DesignGuide|apps UX design guidelines]]
* [[Apps/DesignGuide|apps UX design guidelines]]
* [[Apps/API|apps submission API]] docs
* [[Apps/API|apps submission API]] docs (- andym)


==== Planned content ====
==== Planned content ====
Line 149: Line 221:
** "appsync", lean cloud data storage for client-side apps (- ianbicking)
** "appsync", lean cloud data storage for client-side apps (- ianbicking)


=== Next steps ===
 
* Develop information architecture to tie content together meaningfully (w/TBD UX help)
=== Next Steps ===
* Define scope for upcoming product milestones (w/Caitlin)
Tentative steps, after August developer release ''(Questions? Ask!)'':
* User research on developers interacting with "previously unknown technology" documentation
* Derive IA
* Redesign nav structure for devhub accordingly
* Visual design
* Separate MDN content from devhub content
** cease pulling MDN content in directly
** develop concise, polished stubs for devhub specifically
** provide one or more external links to MDN at the bottom of each of the stubs
** investigate "player card" (contextual MDN content) inside those stubs
** investigate contextual navigation for people reaching MDN from devhub

Latest revision as of 21:51, 30 August 2012

This page contains all of the important details for the Apps Developers project (marketplace.mozilla.org/developers).

Elevator Pitch

Imagine you're a web developer and you want to learn about this Open Web Apps thing. The Apps Developers project focuses on explaining what this is, what you can do with it and how to build a web app, providing you with guidance and resources along the way.

Overview

Project Status

  • Phase 2. (see below)
  • Target release date: Q3 2012 goal

Developer Hub vs. MDN

To avoid confusion and duplication, the distinction between the developer hub and MDN is important:

Devhub:

  • provides tutorials and end-to-end guide from ideation to publishing/maintaining an app
  • outlines platform capabilities
  • links to resources
  • provides links to download key developer products, like development templates, web components
  • has examples and excerpts
  • limited scope to "interesting aspects" of the apps stack
  • does not go into nitty-gritty details of APIs and all conceivable tools

MDN:

  • Canonical source of all docs content, even the content displayed as part of the dev hub (devhub pulls specific data from MDN)
  • has in-detail API documentation, for all relevant APIs
  • covers the entire web stack

Development Phases

Phase 1: General Apps Landing Page and Tutorial

Phase 2: Turn Developer Hub into a one-stop destination

Draft-template-image.png THIS PAGE IS A WORKING DRAFT Pencil-emoji U270F-gray.png
The page may be difficult to navigate, and some information on its subject might be incomplete and/or evolving rapidly.
If you have any questions or ideas, please add them as a new topic on the discussion page.

marketplace.m.o/developers should be a one-stop destination for developers who want to develop open web apps.

DevHub Structure

Priorities

Whiteboard Drafts

Nav Structure

cf. whiteboard drafts for sketches

  • Global structure, always visible:
    • Front page (placeholder. "Developer Hub", perhaps?)
    • Developers
    • Partners
    • Support
  • Front page sections:
    • Platform pitch (borrow from phase 1 content)
    • Developers
    • Partners
    • Support
  • Developers page:
    • Get started
      • HTML5 etc. (technology basics)
      • Manifests etc (parts of an open web app)
      • Application types / security model (TBD) (not in August unless we have content already? Mark?)
      • tutorials and examples
    • Design it
    • Code it
      • Firefox Dev Tools (Nightly+responsive mode)
      • emulators test environments (not in August)
      • templates (mortar)
      • web components (x-tags)
    • Publish it
      • Hosting / packaging
      • Payments (Wil?) (not in August)
      • Metrics (Wil?) (not in August)
      • Updates (not in August?)
      • Marketplace submission
  • Partners page:
    • Reach
      • Firefox OS - Emerging Market/New smartphone users
    • Open
      • Based on standard web technologies (limiting/eliminating fragmentation)
      • Capturing a native like experience using standard web technologies
    • Choice
      • Direct User-Developer relationship
      • Light Approval Process
      • No need to resubmit apps for updated content
  • Support page:
    • Landing page: Where to find help about open web apps and the marketplace

Implementation bugs

Tracking bug: bug 782374

No results.

0 Total; 0 Open (0%); 0 Resolved (0%); 0 Verified (0%);


Content pieces

Existing/in-progress content

Planned content

  • landing page for potential partners.
  • Developer support ("stack overflow") (- Ibai, Janet)
  • additional tools/tutorials
    • backend pieces for mortar (Heroku? - tofumatt)
    • "appsync", lean cloud data storage for client-side apps (- ianbicking)


Next Steps

Tentative steps, after August developer release (Questions? Ask!):

  • User research on developers interacting with "previously unknown technology" documentation
  • Derive IA
  • Redesign nav structure for devhub accordingly
  • Visual design
  • Separate MDN content from devhub content
    • cease pulling MDN content in directly
    • develop concise, polished stubs for devhub specifically
    • provide one or more external links to MDN at the bottom of each of the stubs
    • investigate "player card" (contextual MDN content) inside those stubs
    • investigate contextual navigation for people reaching MDN from devhub