mozilla
Your Search Results

    Apps documentation status

    This page aims to track all ongoing Open Web Apps documentation work; each section covers a different topic/task area. For more information about specific API documentation, you should cross reference this page with the API documentation status page.

    Summary

    Pages No tags Needs* tags Missing tags Editorial reviews Technical reviews Outdated pages Dev-doc-needed bugs Documentation requests
    288 23 (8%) 18 (7%) 0 (0%) 12 (5%) 53 (19%) 36 (13%) 22 (8%) 9 (4%)

    See also localization status of this section.

    No tags

    Found 23 pages:

    Needs* tags

    Found 18 pages:

    Editorial reviews

    Found 12 pages:

    Technical reviews

    Found 53 pages:

    Outdated pages

    Found 36 pages:

    Dev-doc-needed bugs

    Found 22 bugs:

    Bug Summary Release
    820206 Validate "Webapps:*" message parameters in the parent process B2G C4 (2jan on)
    824697 Installing a Hosted App that Preloads the Appcache, updating the appcache, manual syncing the app - no updates found B2G C4 (2jan on)
    831246 Enforce the mime type check for webapp manifests same and cross origin, not just cross-origin ---
    772358 Enumerate elevated privileges in manifest ---
    790558 Add install/update API ---
    768931 Each permission in the manifest should support a corresponding "intended usage" ---
    1137498 Prevent updates changing short_name mozilla39
    1000305 Implement new API function for fetching app icons mozilla38
    982874 Import / export API for apps mozilla36
    1072090 Add a way to enable and disable an app. mozilla36
    965970 Add support to compile asm.js code at install/update time mozilla31
    757226 Implement mozApps app.replaceReceipt() mozilla29
    849335 Make the FMRadio API privileged mozilla22
    821288 Strange behavior when installing multiple hosted apps from the same origin mozilla21
    826555 Ensure that updates can't rename an app mozilla21
    806624 (dev mode only) Support using hosted apps with certified permissions mozilla19
    789527 Change the way we install packaged apps mozilla18
    790870 Implement install/update API during installation of hosted apps mozilla18
    779982 Change behaviour of getSelf and add amInstalled function mozilla18
    786710 The launch_path of a manifest allows for absolute URLs to launch an app at - this should not be allowed mozilla18
    781379 getNotInstalled should be under mgmt and return apps from all origins mozilla17
    772363 Implement installation API for packaged apps mozilla16

    Browse as bug list.

    Documentation requests

    Found 9 bugs:

    Bug Summary
    724105 Apps MDN Page Docs: Add checklist to Submitting an app article
    900502 B2GOnlyHeader2 macro uses confusing/out-of-date terminology
    901039 Document FxOS changes for user agents
    912852 Update App Manifest Documentation on MDN for Third Party Keyboard Support
    926500 What to do about Firefox OS open web app components
    973562 Price point table script should identify countries in a proper way and extend the supported countries
    1008924 working with common libraries invalid link
    1033056 Manifest docs need to better cover compatibility and availability of specific features
    1079939 "Certified" APIs don't offer any certification and therefor should be renamed

    Browse as bug list.

    Localizations

    Please help us to localize this documentation into different languages.

    Language Pages Translated Translations up to date
    bn-BD 288 27 (9%) 4 (14%)
    de 288 28 (9%) 2 (7%)
    es 288 49 (17%) 12 (24%)
    fa 288 10 (3%) 2 (20%)
    fr 288 61 (21%) 19 (31%)
    it 288 31 (10%) 4 (12%)
    ja 288 102 (35%) 55 (53%)
    ko 288 13 (4%) 0 (0%)
    pl 288 7 (2%) 3 (42%)
    pt-BR 288 38 (13%) 3 (7%)
    ru 287 20 (6%) 5 (25%)
    zh-CN 288 30 (10%) 8 (26%)
    zh-TW 282 26 (9%) 6 (23%)

    Content outline

    • Green: complete
    • Yellow: in progress
    • Red: not started
    • Number of stars against article name indicates priority: *** is high, ** is medium, * is low

    Build overview

    The landing page provides a list of links and description to each section consisting the AppCenter/Build.

    App layout

    This section is not in the menu: consider to add it or link it by the Build overview

    Articles in the app layout section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    **Using the full screen            
    *Dealing with portait and landscape-speific layouts            
    *Serving a separate view for specific devices            

    Installable apps for Firefox OS

    Articles in the Installable apps section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    **Creating an application update system There is already some minimal info at updating apps, but this could easily be improved upon. Julien Wajsberg has written a nice little template that allows you to do this, and has agreed to write some notes and a finished demo for us to publish on the subject. His early work on this is at self-updating-packaged-app Install API, done    

    Basic data flow

    The landing page is ok, but a bit sparse, and would need better examples and recommendations.

    Articles in the Basic data flow section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    HTTP basics Karl Dubost wrote some really good HTTP articles for dev.opera.com. Perhaps we could erpublish those?  

     

         
    Ajax basics (architecture, technique)            
    Data storage systems and Ajax            
    Handling offline Ajax and timeouts            
    Handling data within the browser Notes: persistant or temporary; technique with cookies vs. storage vs. IndexedDB vs. data attributes). For offline stuff, defer to the Offline section          
    Advanced Ajax topics, such as UI interaction and perceived performance            
    Links to other useful demos and resources            

    Gather and modify data

    Chris and Franciov took care of the landing page.

    Articles in the Gather and modify data section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    Reading and writing files on your device Reference documentation is okay  

    FileHandle API, currently in draft

    Device Storage API, done

    ,    
    Plotting yourself on the map

    Franciov has written the Plotting yourself on the map article+demo.

    Geo

    Chris has written a simple geolocation demo.

    Geolocation API, done (see Using geolocation)    
    Keep it level: responding to device orientation changes Franciov has written the Keep it level: responding to device orientation changes article+demo. Rolling ball Detecting device orientation, done    
    Updating phone contacts from the web Franciov has written the Updating phone contacts from the web article+demo, to be kept up-to-date with the latest W3C specifications as soon as they are stable/implemented.

    Geo

    baron0 (IRC) might be working on a demo

    Contacts API, completed, to be kept up-to-date with the latest W3C specification and bugzilla bugs    
    Retrieving Battery status information Franciov has written the Retrieving Battery status information article+demo, to be kept up-to-date with the latest W3C specifications as soon as they are stable/implemented.

    Low Energy Messenger

    Chris has written a simple Firefox OS app that shows battery level and charged status in two different ways.

    Battery Status API, completed, to be kept up-to-date with the latest W3C specification and bugzilla bugs  

    bug 1050749
    bug 1050752bug 1050746

    Optimizing for high and low network speeds Franciov has written the Optimizing for high and low network speeds article+demo, to be kept up-to-date with the latest W3C specifications as soon as they are stable/implemented. Net Pics Network Information API, done, to be kept up-to-date with the latest W3C specification.    
    Near, or far? responding to proximity Franciov has written the Near or far? Responding to proximity article+demo.

    Low Energy Messenger

    Proximity API, done    
    Responding to light conditions Franciov has written the Responding to light conditions article+demo, to be kept up-to-date with the latest W3C specifications as soon as they are stable/implemented. Xmas Tales Using Ambient Light Events, completed, to be kept up-to-date with the latest W3C specifications, mailing-list discussion, and bugzilla bug    
    Web activities can probably fit in here as well.            

    User notifications

    Chris and Franciov took care of the landing page.

    Articles in the Control the display section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    ***Notifying users, via system notifications and alarms Three articles written by Chris, covering the general area of detecting when to notify users, how to detect when a deadline is up, and using the notification and vibration apis. We still to write an article about the Alarm API.  

    Time/Clock API (Time and Clock), done

    Notification API (Using Web Notifications), needs update, see bug

    Alarm API (Alarm), done

    , ,   bug 899574
    **Wake me up! starting apps in response to events     Simple Push API (Simple Push API), draft    
    **Providing user feedback via vibrations     Vibration API, done    

    User input and controls

    Chris and Franciov took care of the landing page.

    Articles in the Control the display section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    ***Fullscreen applications     Fullscreen API, draft    
    **Locking the screen orientation     Screen orientation API (see Managing screen orientation)    
    *Locking the pointer to simulate 3D or locational movement

    Franciov: the API docs provides a simple pointer lock demo to show you how to use it to set up a simple control system. The demo uses JavaScript to draw a ball inside a element. When you click the canvas, pointer lock is then used to remove the mouse pointer and allow you to move the ball directly using the mouse.

    Simple pointer lock demo

    Pointer Lock API (was Mouse Lock API), draft    
    ***Drag and drop: a game or a survey implementing drag&drop would be cool to show     Drag Operations, updated in Q3 2014      
    ***Touch events: a photogallery or a game based on touch events would be cool to show Franciov/Niklas/Andrzej are working on it at the HackOnMDN Berlin   Touch Events, article in need of technical review      
    *contentEditable Franciov added a link to a html5demos.com example showing how contenteditable can be used to create an editable document section, the state of which is then saved using LocalStorage. contentEditable demo contentEditable      

    Offline apps

    Chris took care of the landing page.

    Note: check the offline app strategies on Mozilla's Google Drive account.

    Articles in the Working offline section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    ***Detecting whether your device is offline     XHR, online and offline events, done    
    ***Offline resources: AppCache versus installable apps. Detecting which one you need    

    AppCache, done

    Installable apps, done

    ,    
    **Storing simple data with localstorage     basic DOM storage written — a number of options to explore here.  
    **Stored complex structured data with IndexedDB  

    eLibri: A powerful library and eBook reader application, written by Marco Castelluccio, winner of the IndexedDB Mozilla DevDerby.

    Chris has written a simple to do list app that stores data using IndexedDB (hasn't everyone?)

    Shuhao Wu is also writing an account of Offline SUMO for MDN

    basic /IndexedDB done, will need an update once the  WebIDL switch has occurred Shuhao started writing on about September 10th, check in with him soon.  
    *Persisting data from on-device storage to a server-side database   Not sure how possible this is, but it sounds like a great idea to work it out.

     

     

         
    ***Offline reference app: It would be great to explore Offline best-practices and provide a decent reference app.            

    Audio and video delivery

    Articles in this section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    ***Taking pictures with your webcam   Chris has mostly written a gUM demo. Needs picture storage built into it. Also would be nice to release it after FxOS starts to support gUM!

    Camera API (see navigator.mozCameras), done, certified only

    gUM, done, currently doesn't work in FxOS

    Web Activities, done

    , ,    
    **More audio stuff, including Web Audio API. A simple radio, dictaphone, and child's robot voice changer type app all sound like good ideas    

    Web Audio API, done, cross browser code available.

    Some <audio> material available, but could be better

    ,    
    **More video stuff. A custom video player would be good, as well as strategies for serving video to low powered devices    

    Some <video> material available, but could be better

       

    Audio and video manipulation

    Articles in this section

    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    **Canvas/WebGL stuff. An instagram API using canvas would be cool to show.    

    Canvas material

    WebGL material

    ,    
    *Let's talk! Creating real time phone and video conferences     Beginner's material added, reference not done.    

    Advanced network communications

    The landing page is TBD: consider integrating this section into "Basic data flow", to be renamed as "Data Flow and Network Communication".

    Articles in the Advanced network communications section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    *Running tasks in the background with web workers, etc - hard on mobile, battery eating            
    **Web sockets / TCP sockets: showing how to use sockets for "Internet of Things" applications would be cool            
    CORS            
    System Ajax            
    Web RTC: showing how to implement a peer-to-peer communication in a real-world example app would be interesting            

    Develop games

    See https://wiki.mozilla.org/MDN/Development/Game_dev_zone for a wider discussion around games dev docs.

    Localization

    Articles in this section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    TBD etc.  

     

         

    Porting

    Articles in this section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    Porting Chrome apps to open web apps Chris has written the starter article, with input from David Clarke. Mark Giffin also interested. David has written a hello world port of the Chrome hello world, but we need more.        

    App performance

    Articles in this section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    TBD etc.  

     

         

    App development FAQ

    This section contains a large set of FAQs.

    App payments

    Articles in the app payments section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    TBD etc.  

     

         

    Firefox Marketplace

    Articles in the marketplace section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    TBD etc.  

     

         

    Firefox OS partners

    Articles in the partners section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    TBD etc.  

     

         

    User services

    Articles in the User services section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    Logging users in with Persona    

    There is some Persona information on MDN already (see Identity integration).

       

    UP/Cloud apps/personalisation

    Mark Mayo did an interesting talk at the Toronto Mozilla summit about the Mozilla cloud technologies — Sync, Persona, push messages, etc.

    Note: these articles probably need arranging in a different way, as they could potentially apply to any kind of app, and aren't really a category in their own right. The Mozilla cloud stuff could possibly have its own landing page eventually, although bear in mind that persona already has it's own landing page.

    Articles in the cloud apps section
    Article Content status Demo/code status Relevant API doc status Tag Schedule Relevant bugs
    Using/Updating sync    

     

         
    Getting updates (Simple Push, push server, etc.) Push API messages don't contain data, they just tell the process to wake up            
    Using Persona in an app            
    User personalization (UP)            
    geolocation/stumbling/war driving - crowd sourced geodata.            

    Topics for coverage in near future

    Weekly Apps docs meetings

    Please note: This meeting is no longer happening on a regular basis, as the need just wasn't really there for it. A meeting will be annouced and run at any time a need is seen for one.

    We have a recurring weekly meeting to discuss apps documentation, and everyone is welcome to join:

    Most Thursdays at 9am West Coast US / Midday East Coast US / 5pm UK / 6pm Europe

    • Location: Chris Mills' Vidyo room. Ping chrismills about it in the #devmo IRC channcel
    • For external meeting access: click on the link below to attend: https://v.mozilla.com/flex.html?roomdirect.html&key=jk4t3cgzH5P3. If you do not have a user account, please enter your name in the "Guest Name" field and then click "Join".
    • To join from a telephone, dial the following number: +1 650 903 0800, x92 99905 or +1 800 707 2533, pin 369 - conf 99905

    Agendas/notes:

    Document Tags and Contributors

    Contributors to this page: Jeremie, franciov, fscholz, markg, chrisdavidmills
    Last updated by: franciov,
    Hide Sidebar