On Tue, Apr 9, 2013 at 5:52 PM, Joe Brockmeier <j...@zonker.net> wrote:
> On Mon, Apr 1, 2013, at 02:54 PM, Phong Nguyen wrote: > > Hi, > > > > I have been working on adding LXC documentation [1]. > > > > LXC is very similar to KVM in terms of setup, so I would like to reuse > > most > > of the KVM sections to avoid duplicate documentation. With the unique IDs > > in the KVM sections, Publican will error out during build because it will > > find duplicate IDs since these sections are included more than once. > > AFAIK, there's no way to reuse the section twice, but you can use an > xref to point the reader to other sections instead of using an include. > > Best, > > jzb > -- > Joe Brockmeier > j...@zonker.net > Twitter: @jzb > http://www.dissociatedpress.net/ > Yes to what Joe and Sebastien said, plus an explicit note that we should definitely use XML IDs in all sections. They are needed for various essential functions, such as creating xrefs and giving meaningful names to HTML output files. <section id="publican-needs-this"> Jessica T.
