[openstack-dev] [Fuel] Improvement of the blueprint specs template

Roman Prykhodchenko me at romcheg.me
Tue Jun 16 15:08:39 UTC 2015


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



-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 842 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150616/3707a8af/attachment.pgp>


More information about the OpenStack-dev mailing list