Thanks David for the guidance and Razique for knowing what our docs mostly do. :) I'm fine with adding the <systemitem class="service"> markup and see what it gains us later.
Does anyone prefer quotation marks around the service names or is there another output style you'd like? Thanks, Anne Anne Gentle | http://justwriteclick.com/ [image: Facebook] <http://facebook.com/conversationandcommunity>[image: Linkedin] <http://linkedin.com/annegentle>[image: Twitter]<http://twitter.com/annegentle> On Thu, May 17, 2012 at 5:32 AM, Razique Mahroua <[email protected]>wrote: > Actually it uses "" eg "nova-volume" is... > I think 90% of the doc uses that convention. But it could be great to have > a convention for it yes :) > > > On Thu, 17 May 2012 05:21:40 +0200, David Cramer < > [email protected]> wrote: > > -----BEGIN PGP SIGNED MESSAGE----- >> Hash: SHA1 >> >> You probably want: >> >> <systemitem class="service"> >> >> http://www.docbook.org/tdg5/**en/html/systemitem.html<http://www.docbook.org/tdg5/en/html/systemitem.html> >> >> The things to think about in deciding whether to mark something like >> this up are: >> >> 1) Do I want to be able to have this thing formatted in a particular >> way? E.g. monospace, bold. >> 2) Do I want to be able to do something else later (index, cross >> reference, etc) with this term? >> >> If either are true, then you should have a policy of marking it up and >> agree on a tag to use. >> >> Typing <systemitem class="service"> probably seems cumbersome, but I >> can add to oxygen a shortcut so that it feels like there's really a >> <service> tag. I.e. you press enter to pull up the context completion >> window, start typing "systemitem"...it autocompletes and you pick >> "systemitem-service" from thei list. Or we could even add a service >> tag to the schema. >> >> David >> >> >> On 05/16/2012 09:37 PM, Lorin Hochstein wrote: >> >>> Hey Razique: >>> >>> >>> No, I was thinking specifically when the user *doesn't* have to >>> type it. For example, this sentence involving nova-volume: "The >>> nova-volume service is responsible for managing attachable block >>> storage devices". >>> >>> >>> Take care, >>> >>> Lorin -- Lorin Hochstein Lead Architect - Cloud Services Nimbis >>> Services, Inc. www.nimbisservices.com >>> <https://www.nimbisservices.**com/ <https://www.nimbisservices.com/>> >>> >>> >>> >>> >>> >>> On May 16, 2012, at 3:28 AM, Razique Mahroua wrote: >>> >>> Hey Lorin :) You mean when the user has to type it ? >>>> >>>> Lorin Hochstein >>>> <mailto:lorin@nimbisservices.**com<[email protected]>> >>>>> 16 mai 2012 >>>>> 05:04 Hi folks: >>>>> >>>>> What tag should we use for marking up Linux service names like >>>>> nova-api and nova-network? Should we use <command>, or >>>>> <literal>, or something else? >>>>> >>>>> Take care, >>>>> >>>>> Lorin -- Lorin Hochstein Lead Architect - Cloud Services Nimbis >>>>> Services, Inc. www.nimbisservices.com >>>>> <https://www.nimbisservices.**com/ <https://www.nimbisservices.com/>> >>>>> >>>>> >>>>> >>>>> >>>>> >>>>> >>>> -- Nuage & Co - Razique Mahroua [email protected] >>>> >>>> <image.jpg> >>>> >>>> >>>> >>> >>> >>> >> -----BEGIN PGP SIGNATURE----- >> Version: GnuPG v1.4.11 (GNU/Linux) >> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ >> >> iQEcBAEBAgAGBQJPtG7BAAoJEMHeSX**G7afUhNeAH/**jmNOn4Iw7MKKQr9enFhUdq1 >> qL3xP6ixeqR+**UZP0HrdTKchM2TLeljDY5gXLYKf1m9**ZofIk5nnFKFBQGlACWC8Z3 >> TjmEQM8XtAJeflmmWWEqnwWZ3kcjz3**ivFB79liHpnkqhaqECcDEAISDLcLn+**2xSW >> SqckiyCusDMffdhSZIZAx9pfY5B6ut**BJlSdDJYNauM+ARlPOtVq9UREy/**UwK5oAe >> QzAzg6u1WkxFOqp+**TdlLhqOcGOqMucL4qGvMQ+**xb6nDMYo0lMJeIrNWzJXDYRBhi >> UaEtg2N+lJeu2cPbrEj+**R95DNQ9ovPhXjtv3n6Pi1HRN746f01**thDR+6HGMNCA4= >> =s5qz >> -----END PGP SIGNATURE----- >> > > -- > Mailing list: > https://launchpad.net/~**openstack-doc-core<https://launchpad.net/%7Eopenstack-doc-core> > Post to : > openstack-doc-core@lists.**launchpad.net<[email protected]> > Unsubscribe : > https://launchpad.net/~**openstack-doc-core<https://launchpad.net/%7Eopenstack-doc-core> > More help : > https://help.launchpad.net/**ListHelp<https://help.launchpad.net/ListHelp> >
-- Mailing list: https://launchpad.net/~openstack-doc-core Post to : [email protected] Unsubscribe : https://launchpad.net/~openstack-doc-core More help : https://help.launchpad.net/ListHelp
