Launch Update

Kuma launched August 3, 2012. This page is now an archive of the pre-launch process

Introduction

"Kuma" is a project to redevelop the MDN website. We will leverage the Kitsune codebase that the new SUMO is built on and plan to customize it to fit our needs. The Kitsune knowledge base (KB) will replace the current Deki wiki, and we will be integrating the Kitsune support forums and discussion forums as needed. Kuma will also benefit from Kitsune l10n, administration, and social interaction features.

Goals

• Improve the MDN experience for developers, demo authors, and documentation contributors.
  • Make it easier for planning, writing, and maintaining docs
  • Make it discoverable to help developers find what they need
  • Make it faster and more stable for visitors and contributors
  • Make it extensible to allow rapid development of new features
• Create a more robust system for l10n contributors
  • Better tracking and diffs so they know when en-US authors create new docs, update existing docs, or do anything for en-US
  • Dashboard for l10n progress and monitoring so locales can better manage their work

Schedule

We plan to develop the initial functionality and test internally through a series of MDN 1.x releases, and will launch Kuma officially as MDN 2.0 in July 2012.

Roadmap & Milestones

   8-30 June - testing (formal and informal)
   7-8 July - bug hunt with Mozilla QA
   10 July - deki shut off for updates (browse only) - final content migration, link to kuma "beta" for browsing
   10-15 July - writing/editing on kuma, continue testing, verify bug fixes
   16 July - cutover 

See the MDN Milestones page for a detailed roadmap and release schedule.

Testing

We are ramping up testing as we approach the launch of Kuma!

• Informal test weekend: Friday, May 11 through Sunday, May 13
• 8 June - 10 June: Informal test weekend
• 14 June - 30 June: Test Adding and Editing Content (usual site activities)
• 7 July - 8 July: bug hunting with Mozilla QA
• 9-13 July - bug and template fixes, editing content on kuma platform

Bugzilla

• Address: https://bugzilla.mozilla.org/buglist.cgi?quicksearch=Kuma&list_id=334028
• Purpose: Assign tasks and track resolutions.

Submitting bugs

• Please use this Bug template.

Features

Background

• UserVoice: Feedback on the current MDN website.
• Localization: We need to review and see what is possible based on the requests of localizers around the world.

• Kuma related requirements/notes
  • Wiki docs TOC - docs team is organizing content under a consistent hierarchy.
  • etherpad from Luke+Jay+James meeting
• Other stuff
  • MDN programs and projects - home for everything related to the Mozilla Developer Network
  • MDN requirements - initial set of features and functionality we need for a good developer and documentation experience on MDN (more stuff will be added over time and a final PRD will be drafted soon)
  • Kitsune roadmap and requirements - home for everything related to the next version of SUMO
  • Overlap doc - early draft of the features that are shared between SUMO and MDN (more details will be added and unique features/tweaks for each application will be noted)

New MDN IA

• URL paths/structure

MDN 1.0 PRD

A draft of the MDN 1.0 PRD lists most of the features that are needed to start the migration away from Deki. The document includes a list of features and their priorities.

• MDN 1.0 PRD
• Kuma Feature List

Kitsune and overlap with SUMO

The documents below outline requirement overlap in SUMO and the MDN. We will collaborate with the SUMO development team to understand what is available in the Kitsune codebase and work through our requirements to build a solid foundation for the MDN website based on the Django framework.

• Notes and Luke's dev analysis
• Etherpad from the Luke/Jay/James meeting

Development

Scrum

The Kuma team will be using Scrum to manage development. Please see the Scrum page and Scrum Guide for more information about the framework.

The team decided that it would be easiest to manage Scrum user stories with Bugzilla, and has written a guide for doing so.

Comprehensive Feature Request List

A comprehensive list of features that have been requested on MDN is provided below. Each feature has its own Wiki page that provides more detail and, in some cases, specific tasks that must be completed.

This list is a compilation and formalization of existing feature lists (including the feature EtherPad, the MDN 1.0 PRD, and the MDN / SUMO Shared Components PRD), and as such is fairly comprehensive.

Kuma User's resources

• Getting started with Kuma
• Introduction to KumaScript