RDINB Suggested RoadMap Format

[resplin]

Obsolete Pages{{Obsolete}}

The official documentation is at: http://docs.alfresco.com

RDINB

Table of Contents

• 1 Proposal


• 2 Example Road Map
  
  
  
  • 2.1 Objectives
  
  
  • 2.2 Objective A
    
    
    
    • 2.2.1 Feature A
    
    
    • 2.2.2 Feature B
    
    
  
  
  • 2.3 Objective B
    
    
    
    • 2.3.1 Initiative C
    
    
  
  
  • 2.4 Objective C
    
    
    
    • 2.4.1 Feature D
    
    
    • 2.4.2 Initiative C
    
    
  
  
  • 2.5 Release Timeline
  
  

Proposal

Road maps are difficult to maintain because like a garden they require constant attention. IMO the Alfresco road map is much better in terms of freshness of content and verbosity than may other OSS projects but there is always room to do better.  This is just one thought about an organization for the roadmap that may be able to satisfy a number of competing factors.

• provide a high level direction for where the product is going (CIO/CTO level summary) -- OBJECTIVES
  
• Provide a summary of each feature as it relates to the objective (Power users and Programmers)
  
• Provide a best effort schedule of what features will be released in which product release (PMs, Power Users and Programmers.)
  

It seems much too difficult to combine these functions in to a single listing.  The proposal below breaks them out in to sections.

Example Road Map

Objectives

• Objective A
  
• Objective B
  
• Objective C
  

Objective A

Feature A

Paragraph about what feature A is and maybe short description about how it meets objective if it is not entirely obvious.

Feature B

Paragraph about what feature B is and maybe short description about how it meets objective if it is not entirely obvious.

Objective B

Initiative C

Paragraph about what initiative C is and why it is (example refactoring) and maybe one line about how it meets objective if it is not entirely obvious.

Objective C

Feature D

Paragraph about what feature D is and maybe short description about how it meets objective if it is not entirely obvious.

Initiative C

Initiative C (linked to above for single description).  Short description on how it meets objective if not entirely obvious.

Release Timeline

Features and initiatives are added to the release timeline as they are understood and can be appropriately scheduled.  The timeline is a best effort estimation and not a hard guarantee that a feature will be in a release.  In an effort to be transparent it may be helpful to provide a level of certainty that the item will be in a given release and in terms of the release, that it will make its given target release date.

 
  
  
 
 
  
  
 

Release Name and Number IE: Community v1.4.1 Target Date / Quarter etc (% confidence) Status: DELIVERED, IN DEVELOPMENT, IN PLANNING Last updated: ##/##/####	Name of Feature % confidence item will be in release Feature A Name as Link % confidence initiative C Name as Link % confidence
Release Name and Number IE: Community v2.0 Target Date / Quarter etc (% confidence) Status: DELIVERED, IN DEVELOPMENT, IN PLANNING Last updated: ##/##/####	Name of Feature % confidence item will be in release Feature B Name as Link % confidence