Apps/Developers: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(Project info)
 
m (→‎Implementation bugs: use right query for bugzilla list)
 
(53 intermediate revisions by 4 users not shown)
Line 1: Line 1:
= Project info =
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.
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.


=== Status ===
== Overview ==
* Phase 1. (see below)
* Prod URL:  https://marketplace.mozilla.org/en-US/developers/  (behind login)
* Target release date: TBD
* Dev URL:  TBD
* '''Status meetings:''' Daily standups, 9:30am Pacific, Vidyo (D. Buchner's room)
* Stage URL: TBD
* Code Repo: [https://github.com/mozilla/zamboni/tree/master/mkt/ecosystem Zamboni/mkt]
* Code: Django (part of Zamboni = AMO/Marketplace)
* Product Owner: Fred Wenzel
* Dev Team: Arron Schaar (dev), Jen Fong (dev)
* IRC Channel: [irc://irc.mozilla.org:6697/devecosystem #devecosystem on irc.mozilla.org]


=== People ===
== Project Status ==
* PM: Daniel Buchner
* Phase 2. (see below)
* UX: Jason Grlicky
* Target release date: Q3 2012 [https://intranet.mozilla.org/2012Q3Goals#Web_Development goal]
* Dev: Arron Schaar


=== Code ===
== Developer Hub vs. MDN ==
* [https://github.com/pennyfx/zamboni/tree/ecosystem Dev branch]
To avoid confusion and duplication, the distinction between the developer hub and MDN is important:
* Staging instance: TBD
 
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 59: 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 72: Line 95:
** Add-on
** Add-on
* Technologies used
* Technologies used
==== Design it! ====
* Layouts
* Responsive Design
* UI/Themes


==== Code it! - [https://docs.google.com/document/d/121JVZ6PSFUIHZsgOnVvdUhTXCkQrgDFXbxcdrHvDnBI/edit content] ====
==== Code it! - [https://docs.google.com/document/d/121JVZ6PSFUIHZsgOnVvdUhTXCkQrgDFXbxcdrHvDnBI/edit content] ====
Line 95: Line 123:
* User Engagement
* User Engagement


== Phase 2: Vertical Coverage for Landing Pages and Tutorials ==
</div></div>
 
== Phase 2: Turn Developer Hub into a one-stop destination ==
{{Draft}}
 
marketplace.m.o/developers should be a one-stop destination for developers who want to develop open web apps.
 
=== 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>


After the initial landing page and tutorial are produced to serve the general apps case, a template will be solidified from that process that will be applied to each app vertical of interest. Games, Video, News & Reading, etc. will all have a landing page and tutorial created that addresses the specific needs of developers creating apps under each umbrella.
=== 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)


== Phase 3: Mozilla Builder ==
==== 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)


The Mozilla Builder is a ecosystem-unifying developer tool that supports app creation from "idea to paid". The Builder will aid in idea formulation, provide a bootstrap for new projects, integrate documentation based on context, provide an authoring environment, help in app testing, and enable publishing to the Mozilla Marketplace, as well as a host of other value added services that support the entirety of the app life-cycle.


__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

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