Hi folks!

I was reviewing one of specs for Fuel 7.0 and realized the information there is 
messed up and it’s pretty hard to put it all together. The reason for that is 
basically that Fuel is a multicomponent project but the template does not 
consider that — there is a Proposed change section which is used to define all 
the changes in the entire project; then there is the API and Data impact 
sections that are specific to only specific components but still have to be 
filled in.

Since most of new features consider changes to several components I propose to 
stick to the following structure. It eliminates the need to create several 
specs to describe one feature and allows to organize everything in one document 
without messing it up:

--> Title
--> Excerpt (short version of the Problem description, proposed solution and 
final results)
--> Problem description
--> Proposed changes
------> Web UI
------> Nailgun
----------> General
----------> REST API
----------> Data model
------> Astute
----------> General
----------> RPC protocol
------> Fuel Client
------> Plugins
--> Impact
------> End-user
------> QA
------> Developer
------> Infrastructure (operations)
------> Upgrade
------> Performance
--> Implementation
------> Assignee
------> Work items
----------> Web UI
----------> Nailgun
----------> Astute
----------> Fuel Client
----------> Plugins
----------> Documentation
--> References


- romcheg



Attachment: signature.asc
Description: Message signed with OpenPGP using GPGMail

__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Reply via email to