Apps/Developers: Difference between revisions

(removed builder for now, quick bullet points for things to be covered in dev hub.)
m (→‎Implementation bugs: use right query for bugzilla list)
 
(46 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page contains all of the important details for the '''Apps Developers''' project.
This page contains all of the important details for the '''Apps Developers''' project (marketplace.mozilla.org/developers).


= Elevator Pitch =
= Elevator Pitch =
Line 10: 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]


== Project Status ==
== Project Status ==
* Phase 1. (see below)
* Phase 2. (see below)
* Target release date: Q2 2012 [https://intranet.mozilla.org/Innovation_Q2_2012_goals#Ecosystem 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 =
== Phase 1: General Apps Landing Page and Tutorial ==
== Phase 1: General Apps Landing Page and Tutorial ==
<div class="NavFrame collapsed">
  <div class="NavHead">Generic Landing Page</div>
  <div class="NavContent" style="text-align:left">
Initially, our strategy to up-level the developer ecosystem will be focused on introduction and information. We will create a compelling landing page and tutorial that lead developers through the subtleties of the general apps development case. In later phases we will expand our landing page + tutorial formula to address other app verticals of interest.
Initially, our strategy to up-level the developer ecosystem will be focused on introduction and information. We will create a compelling landing page and tutorial that lead developers through the subtleties of the general apps development case. In later phases we will expand our landing page + tutorial formula to address other app verticals of interest.


Line 61: 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 101: Line 122:
* Updates
* Updates
* User Engagement
* User Engagement
</div></div>


== Phase 2: Turn Developer Hub into a one-stop destination ==
== Phase 2: Turn Developer Hub into a one-stop destination ==
{{Draft}}
{{Draft}}
- templates (mortar, webgamestub)
- web components (x-tags)
- tutorials and end-to-end "walkthrough"
- apps UX design guidelines
- apps submission API


and probably:
marketplace.m.o/developers should be a one-stop destination for developers who want to develop open web apps.
- a landing page for potential partners.
 
=== DevHub Structure ===
==== 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
 
=== Implementation bugs ===
Tracking bug: {{bug|782374}}
 
<bugzilla>
{
  "product": "Marketplace",
  "component": "Developer Pages",
  "blocks": "782374",
  "resolution": "---"
}
</bugzilla>
 
=== Content pieces ===
==== Existing/in-progress content ====
* [[Apps/Mortar|open web apps development templates]] (mortar - ''jlongster'', webgamestub - ''dmose'')
* [[Apps/x-tag|web components]] (x-tags - ''dbuc'')
* tutorials and end-to-end "walkthrough"
** ''Outline and resources above (stage 1).''
** [https://developer-new.mozilla.org/en-US/docs/Apps/Tutorials/General General tutorial] on 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/API|apps submission API]] docs (- andym)
 
==== 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)




__NOTOC__
=== 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

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

  THIS PAGE IS A WORKING DRAFT  
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