[yocto] any plans on more carefully distinguishing docbook markup in yocto docs?

Robert P. J. Day rpjday at crashcourse.ca
Tue Jun 17 05:51:17 PDT 2014


  i'm sure i asked this once before, but is there any long-term plan
for more carefully marking up the yocto docs semantically? as in, most
things that represent filenames or variables or commands or code are
simply tagged as <filename>, even when this is not really appropriate.

  to be semantically precise, one should be more carefully selecting
among tags such as <filename>, <varname>, <command>, <code> and so on.
for now, i suspect the rendering toolchain wouldn't change what's
eventually produced, but in the future, i think more careful markup
would allow the generation of much prettier docs.

  thoughts?

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================



More information about the yocto mailing list