[Openstack-docs] orderedlist vs procedure

Anne Gentle anne at openstack.org
Thu Jul 25 15:51:56 UTC 2013


On Thu, Jul 25, 2013 at 10:48 AM, Diane Fleming <diane.fleming at rackspace.com
> wrote:

>   I think it's the right way to go -  procedures.
>

I do too.

As far as style goes, do we want military style numbering for procedure
titles, such as 3.1, 3.2, 3.3? That's how they're output in HTML now.

Anne


>
>   *Diane*
>  *----------------------------------------------*
>  Diane Fleming
>  Software Developer II - US
>  diane.fleming at rackspace.com
> Cell  512.323.6799
> Office 512.874.1260
>  Skype drfleming0227
> Google-plus diane.fleming at gmail.com
>
>   From: Anne Gentle <anne at openstack.org>
> Date: Thursday, July 25, 2013 10:25 AM
> To: "openstack-docs at lists.openstack.org" <
> openstack-docs at lists.openstack.org>
>
> Subject: [Openstack-docs] orderedlist vs procedure
>
>   Hi all,
> I've noticed a general trend towards using <procedure> markup and I like
> it, even though our original Conventions indicate to use <orderedlist>. [1]
>
>  Would it be okay to change our Conventions to prefer <procedure> for
> tasks as opposed to <orderedlist>?
>
>  Let me know and I'll make the change to the wiki page. Changes to the
> source can be done over time.
>
>  Anne
>
>  1.
> https://wiki.openstack.org/wiki/Documentation/Conventions#Ordered_procedure_to_follow_.28where_step_2_needs_to_be_done_after_step_1.29
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130725/0b5064c7/attachment.html>


More information about the Openstack-docs mailing list