Diff for "DocTeam/Specs"

Not logged in - Log In / Register

Differences between revisions 7 and 8
Revision 7 as of 2007-06-18 11:55:01
Size: 4478
Editor: 82-47-115-18
Comment: Added blueprint overview
Revision 8 as of 2007-06-18 12:07:54
Size: 5128
Editor: 82-47-115-18
Comment: Added answers overview
Deletions are marked like this. Additions are marked like this.
Line 91: Line 91:

[[Anchor(answers-overview)]]
== answers-overview ==

 * Overview: A high level introduction to Launchpad's Answer Tracker.
 * Goal/Deliverables: An article at help.launchpad.net and a corresponding link in the WhatIsLaunchpad page.
 * Full spec: none
 * Depends on: n/a

'''This guide will be ready for review when it has:
 * problem of community knowledge being spread amongst various resources
 * need to make that knowledge searchable and discoverable
 * karma as a motivator
 * answer tracking - make sure questions stand a better chance of getting answers
 * answer contacts - as above and chance for good community involvement.

ContentsBRTableOfContents

Overview

This page contains many mini-specs for new guides for help.launchpad.net.

  • Overview: A Launchpad project where we can register blueprints for new support materials and, if appropriate, users can file bugs against existing documentation.
  • Goal/Deliverables: A project in Launchpad, several blueprints linked to mini-specs and a public announcement.
  • Full spec: none
  • Depends on: n/a

We will know we are ready to announce the project when we have registered it in Launchpad and have enough blueprints to cover the basics of Launchpad.

Anchor(what-is-launchpad)

what-is-launchpad

Blueprint: https://blueprints.launchpad.net/launchpad-documentation/+spec/what-is-launchpad

  • Overview: A high level overview of Launchpad and its applications, intended as a jumping-off point for other documentation.
  • Goal/Deliverables: An article at help.launchpad.net and a corresponding link on the help home page.
  • Full spec: none
  • Depends on: bug-tracker-overview, code-hosting-overview, translations-overview, blueprint-tracker-overview, answer-tracker-overview

This guide will be ready for review when it has:

  • an overview description of Launchpad and its role in the lifecycle of the projects that use it
  • a description of how Launchpad handles collaboration and its suitability for the free software development process and community
  • an overview of each of Launchpad's generally available applications (i.e. not Soyuz)
  • a high-level description of how Launchpad interacts with Bazaar.

Anchor(bug-tracker-overview)

bug-tracker-overview

  • Overview: A high level introduction to the Launchpad Bug Tracker.
  • Goal/Deliverables: An article at help.launchpad.net and a corresponding link in the WhatIsLaunchpad page.

  • Full spec: none
  • Depends on: n/a

This guide will be ready for review when it has:

  • high level description of the Launchpad bug tracker
  • introduction to multi-project bugs
  • introduction to external bug watches
  • overview of the email interface
  • introduction to integration with Code Hosting
  • examples of projects using the Launchpad Bug Tracker.

Anchor(code-hosting-overview)

code-hosting-overview

  • Overview: A high level introduction to Launchpad Code Hosting.
  • Goal/Deliverables: An article at help.launchpad.net and a corresponding link in the WhatIsLaunchpad page.

  • Full spec: none
  • Depends on: n/a

This guide will be ready for review when it has:

  • high level description of managing revision history using Bazaar
  • explanation of why projects and individuals might want to host/mirror code on Launchpad
  • introduction to CVS/SVN import and an explanation of how people can access that code with Bzr and why
  • overview of the branch directory, mentioning links to blueprints and bugs.

Anchor(translations-overview)

translations-overview

  • Overview: A high level introduction to Launchpad Translations.
  • Goal/Deliverables: An article at help.launchpad.net and a corresponding link in the WhatIsLaunchpad page.

  • Full spec: none
  • Depends on: n/a

This guide will be ready for review when it has:

  • high level description of the need for a simple way for translators to translate, without touching .po files directly
  • explanation of the collaborative nature of Launchpad Translations and the benefits therein
  • mention of: suggestions, translation team policies, standards compatible file export and import
  • links to some of the projects using Launchpad Translations.

Anchor(blueprint-overview)

blueprint-overview

  • Overview: A high level introduction to Launchpad's Blueprint Tracker.
  • Goal/Deliverables: An article at help.launchpad.net and a corresponding link in the WhatIsLaunchpad page.

  • Full spec: none
  • Depends on: n/a

This guide will be ready for review when it has:

  • high level description of what blueprints are
  • explanation of: priority, definition status, delivery, assignee, targeting
  • introduction to dependencies and road maps
  • introduction to meetings/sprints
  • mention of use of existing wiki
  • mention of ability for anyone to create a blueprint but project drivers to decide what is implemented.

Anchor(answers-overview)

answers-overview

  • Overview: A high level introduction to Launchpad's Answer Tracker.
  • Goal/Deliverables: An article at help.launchpad.net and a corresponding link in the WhatIsLaunchpad page.

  • Full spec: none
  • Depends on: n/a

This guide will be ready for review when it has:

  • problem of community knowledge being spread amongst various resources
  • need to make that knowledge searchable and discoverable
  • karma as a motivator
  • answer tracking - make sure questions stand a better chance of getting answers
  • answer contacts - as above and chance for good community involvement.

DocTeam/Specs (last edited 2008-06-17 14:21:19 by localhost)