Apps/Developers: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
m (→‎Implementation bugs: use right query for bugzilla list)
 
(28 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), Jen Fong (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 83: 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 136: Line 135:


==== Whiteboard Drafts ====
==== Whiteboard Drafts ====
* [http://people.mozilla.com/~fwenzel/files/debhub/wb-frontpage.jpg Front page]
* <del>[http://people.mozilla.com/~fwenzel/files/debhub/wb-frontpage.jpg Front page]</del>
* [http://people.mozilla.com/~fwenzel/files/debhub/wb-devs.jpg Developers]
** [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-partners.jpg Partners]
* [http://people.mozilla.com/~fwenzel/files/debhub/wb-support.jpg Support]
* [http://people.mozilla.com/~fwenzel/files/debhub/wb-support.jpg Support]


==== Proposed Page Structure ====
==== Nav Structure ====
cf. whiteboard drafts for sketches
cf. whiteboard drafts for sketches


Line 149: Line 150:
** Partners
** Partners
** Support
** Support
* Front page sections:
* Front page sections:
** Platform pitch (borrow from phase 1 content)
** Platform pitch (borrow from phase 1 content)
** Developers (link to tutorials for webdevs, native devs, and to tools section)
** Developers
** Partners (content tbd)
** Partners
** Support
 
* Developers page:
* Developers page:
** Get started
** Get started
*** HTML5 etc. (technology basics)
*** HTML5 etc. (technology basics)
*** Manifests etc (parts of an open web app)
*** Manifests etc (parts of an open web app)
*** Application types / security model (TBD)
*** <span style="opacity:.5">Application types / security model (TBD)</span> (not in August unless we have content already? Mark?)
*** example apps
*** tutorials and examples
*** tutorials
** Design it
** Design it
*** (subsections as developed by [[Apps/Design]] project)
*** (subsections as developed by [[Apps/Design]] project)
** Code it
** Code it
*** templates
*** Firefox Dev Tools (Nightly+responsive mode)
*** emulators
*** <span style="opacity:.5"><del>emulators</del> test environments</span> (not in August)
*** templates (mortar)
*** web components (x-tags)
*** web components (x-tags)
** Publish it
** 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
*** Marketplace submission
*** Hosting / packaging
 
*** Payments
*** Metrics
*** Updates
* Partners page:
* Partners page:
** Content TBD
** 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:
* Support page:
** Content TBD
** 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 ===
=== Content pieces ===
Line 196: Line 222:




=== Next steps ===
=== Next Steps ===
* <del>Fred: Transcribe whiteboard.</del>
Tentative steps, after August developer release ''(Questions? Ask!)'':
* Fred: Work with Jen to develop devhub framework / sections
* User research on developers interacting with "previously unknown technology" documentation
* dbuc: Reach out to BD to get content sections for partners page
* Derive IA
* Fred: Work with MDN: ''(reached out, waiting for reply)''
* Redesign nav structure for devhub accordingly
** get simple API to pull content (no scraping).
* Visual design
** discuss permission system and update model for content from MDN.
* Separate MDN content from devhub content
* <del>Fred: reach out to Ibai about support section (Scope!)</del>
** cease pulling MDN content in directly
* Fred: Meet with L10n folks to put localization onto the roadmap
** develop concise, polished stubs for devhub specifically
* Thomas and Diana: determine content for partners section
** 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