Open Stack

Right now, it generates only WADL files - the wrapper docbook files are created manually. 

The one issue is, how do we review the generated WADL files? Like with the auto-generated configuration options, any errors must be fixed in the code and not in the actual WADL files (or configuration tables). I think we need to make that process easier - right now, it's not clear how to make updates in either case. I know the configuration tables have a message that says not to edit them, and to edit the code directly, but I just give up when I see that - since I'm not sure how to actually do that. 

diane
________________________________________
From: Nicholas Chase [nchase at mirantis.com]
Sent: Thursday, November 28, 2013 11:10 PM
To: Anne Gentle
Cc: openstack-docs at lists.openstack.org
Subject: Re: [Openstack-docs] Auto-generating Ceilometer documentation.

On 11/28/2013 3:33 PM, Anne Gentle wrote:

> Also, are you generating docbook in addition to wadl or just wadl? I see
> the code in stackforge has a lot of docbook naming but I don't know if
> it's really generating docbook.

Right, I got the impression that it was JUST generating docbook, hence
my confusion.

----  Nick

_______________________________________________
Openstack-docs mailing list
Openstack-docs at lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs