Meego Wiki
Views

SDK/Meetings/1st Documentation

From MeeGo wiki
< SDK | Meetings(Difference between revisions)
Jump to: navigation, search
m (Content areas (for discussion, to be updated in the meeting))
m (Other topics proposed: add link)
 
(6 intermediate revisions not shown)
Line 1: Line 1:
= Documentation Team Kick Off Meeting Agenda =
= Documentation Team Kick Off Meeting Agenda =
 +
 +
== Attendees ==
 +
Titta Väyrynen, Veli Kaksonen, Ville Lavonius, Ronan Mac Laverty,Murali Krishna Punaganti, Bob Spencer, Elliot Smith
== Agenda for the kick off meeting ==
== Agenda for the kick off meeting ==
Line 5: Line 8:
* Introductions
* Introductions
* MeeGo 1.1 release: target format/s and site/s
* MeeGo 1.1 release: target format/s and site/s
-
** Ronan to provide the latest info on developer.meego.com
+
**developer.meego.com - release planned to be done at the same time as the SDK release. Ronan can give an account and password for anyone who needs it. 
 +
** Adding content directly into Drupal  - possible  4.10.2010 (AP Ronan: confirm the date)
 +
** Decision: start producing content in wiki, checkpoint later to see which content to move to Drupal (exception: API doc as HTML and QCH file)
 +
** Ronan can create initial content structure for the release, today
* Agreeing on ways of working
* Agreeing on ways of working
-
** Meetings, communication channels
+
** Meetings, communication channels - #meego-sdk @ freenode
-
** Backlog (storing requirements and following task progress)
+
** Backlog (storing requirements and following task progress) - use wiki for now, move to Bugzilla for 1.2
-
** Sharing work-in-progress drafts
+
** Sharing work-in-progress drafts - let's use apidocs.meego.com for API documentation. Access from Mike Shaver
* First rough draft of a content plan
* First rough draft of a content plan
** Discussion
** Discussion
-
** Dividing content into areas and assigning owners for the areas
+
** Dividing content into areas and assigning owners for the areas - done, see below
** Possibly roadmapping some content areas for later releases?
** Possibly roadmapping some content areas for later releases?
* Agreeing on an approval process (testing, reviews)
* Agreeing on an approval process (testing, reviews)
-
** When should the content be ready for reviews and for testing?
+
** When should the content be ready for reviews and for testing? - two weeks before the release
-
** Test procedural information (step-list instructions)
+
** Test procedural information (step-list instructions) - agree in next meeting
-
** Suggestions for reviewers?
+
** Suggestions for reviewers? - agree in next meeting
-
** Who gives final approval?
+
** Who gives final approval? - agree in next meeting
* Release updates after the official release day
* Release updates after the official release day
-
** How to manage updates to content? Sprints?
+
** How to manage updates to content? Sprints? - agree in next meeting
 +
 
-
=== Content areas (for discussion, to be updated in the meeting)===
+
=== Content areas ===
-
* Terminology/glossary
+
* Terminology/glossary (Titta)
-
* Release overview, description of the developer offering
+
* Release overview, description of the developer offering (Ronan)
-
* Overview of MeeGo websites and their purpose
+
* Overview of MeeGo websites and their purpose (Ronan)
-
* Setup/Getting started instructions for application developers (from installation to first app, divide into smaller areas in meeting)
+
* Setup/Getting started instructions for application developers (from installation to first app, divide into smaller areas in meeting)   (Bob, Veli)
-
* Setup/Getting started instructions for platform developers
+
* Setup/Getting started instructions for platform developers (community-driven area)
-
* Other tool instructions (what is needed here?)
+
* Other tool instructions (e.g. linking to information on Qt tools, MADDE, MAD-Developer, Packaging tools, OBS use, appstore submission tools, performance tools) (Elliot)
-
* Architecture overview
+
* Architecture overview  (Titta)
-
* API reference and API overview  
+
** Sunil / Arjan and Sakari updating.  Representation changing.
 +
* API reference and API overview : Qt 4.7, Qt mobility 1.0, Meego Touch (MTF), WRT (Murali Punaganti)
 +
** Need to follow-up on platform API.  How will it be presented.
* UI guidelines
* UI guidelines
-
* Samples
+
** Elliot: I verified with the design team in the UK that the [http://meego.com/developers/ui-design-guidelines/handset design guidelines for handset] are current and valid; they were written by Nokia and are the basis of the reference handset UX design. No similar guidelines for netbook are planned.
-
* Packaging and publishing
+
** Elliot: whether we want to move this content to developer.meego.com is an open issue
-
* Release notes
+
* Samples (existing hello world level examples for Qt, Qt mobility, MeeGo Touch, and WRT)  (Elliot and Kerry Jiang (PRC SDK mgr))
-
* Productization (covers all areas to some extent, but should this be a separate item?)
+
* Packaging and publishing (covered in other tool instr.)
 +
* Release notes (Veli, Bob)
 +
* Productization (covers all areas to some extent, but should this be a separate item?) (Titta, Ville)
-
===Other topics proposed: ===
+
=== Other topics proposed ===
-
* API documentation
+
-
** who owns this?
+
-
** layout (still not here)
+
-
** how are netbook & handset documentation harmonized?
+
-
** content (limited to Qt & mobility + OpenGL ES)
+
-
* Other documentation
+
-
** who owns this?
+
-
** is there an agreed plan how to move forward?
+
-
** what architecture documentation will be provided?
+
* Sample applications
* Sample applications
-
** will there be some extended examples?
+
** Need sample for each major type of task (eventually).  e.g.  How to create mutlimedia app, how to use telephony apis, how to use social web services, etc.
-
* What do we do with the current documentation in wiki.meego.com ?
+
* What do we do with the current documentation in [[Main Page|wiki.meego.com]]?
 +
* look-and-feel (Style Guide  exists, but CSS available on 4.10.
 +
* define a  process for adding new material to sites

Latest revision as of 10:59, 15 March 2011

Contents

Documentation Team Kick Off Meeting Agenda

Attendees

Titta Väyrynen, Veli Kaksonen, Ville Lavonius, Ronan Mac Laverty,Murali Krishna Punaganti, Bob Spencer, Elliot Smith

Agenda for the kick off meeting

  • Introductions
  • MeeGo 1.1 release: target format/s and site/s
    • developer.meego.com - release planned to be done at the same time as the SDK release. Ronan can give an account and password for anyone who needs it. 
    • Adding content directly into Drupal  - possible  4.10.2010 (AP Ronan: confirm the date)
    • Decision: start producing content in wiki, checkpoint later to see which content to move to Drupal (exception: API doc as HTML and QCH file)
    • Ronan can create initial content structure for the release, today
  • Agreeing on ways of working
    • Meetings, communication channels - #meego-sdk @ freenode
    • Backlog (storing requirements and following task progress) - use wiki for now, move to Bugzilla for 1.2
    • Sharing work-in-progress drafts - let's use apidocs.meego.com for API documentation. Access from Mike Shaver
  • First rough draft of a content plan
    • Discussion
    • Dividing content into areas and assigning owners for the areas - done, see below
    • Possibly roadmapping some content areas for later releases?
  • Agreeing on an approval process (testing, reviews)
    • When should the content be ready for reviews and for testing? - two weeks before the release
    • Test procedural information (step-list instructions) - agree in next meeting
    • Suggestions for reviewers? - agree in next meeting
    • Who gives final approval? - agree in next meeting
  • Release updates after the official release day
    • How to manage updates to content? Sprints? - agree in next meeting


Content areas

  • Terminology/glossary (Titta)
  • Release overview, description of the developer offering (Ronan)
  • Overview of MeeGo websites and their purpose (Ronan)
  • Setup/Getting started instructions for application developers (from installation to first app, divide into smaller areas in meeting)   (Bob, Veli)
  • Setup/Getting started instructions for platform developers (community-driven area)
  • Other tool instructions (e.g. linking to information on Qt tools, MADDE, MAD-Developer, Packaging tools, OBS use, appstore submission tools, performance tools) (Elliot)
  • Architecture overview  (Titta)
    • Sunil / Arjan and Sakari updating.  Representation changing.
  • API reference and API overview : Qt 4.7, Qt mobility 1.0, Meego Touch (MTF), WRT (Murali Punaganti)
    • Need to follow-up on platform API.  How will it be presented.
  • UI guidelines
    • Elliot: I verified with the design team in the UK that the design guidelines for handset are current and valid; they were written by Nokia and are the basis of the reference handset UX design. No similar guidelines for netbook are planned.
    • Elliot: whether we want to move this content to developer.meego.com is an open issue
  • Samples (existing hello world level examples for Qt, Qt mobility, MeeGo Touch, and WRT)  (Elliot and Kerry Jiang (PRC SDK mgr))
  • Packaging and publishing (covered in other tool instr.)
  • Release notes (Veli, Bob)
  • Productization (covers all areas to some extent, but should this be a separate item?) (Titta, Ville)

Other topics proposed

  • Sample applications
    • Need sample for each major type of task (eventually).  e.g.  How to create mutlimedia app, how to use telephony apis, how to use social web services, etc.
  • What do we do with the current documentation in wiki.meego.com?
  • look-and-feel (Style Guide  exists, but CSS available on 4.10.
  • define a  process for adding new material to sites
Personal tools