[publican-list] Oddities with draft settings

[Jeff Fearn]

Jeff Fearn wrote:
> Hi ho, I have been taking a look at drafting due to 
> https://bugzilla.redhat.com/show_bug.cgi?id=468305 and there is some 
> crazy stuff happening in the default DocBook XSL.
> 
> In HTML you can only get the draft image in the background in the root 
> node for the current page and everything on that page is marked as draft.
> 
> In html-single you have to set status to draft in the book and 
> everything in the book is marked.
> 
> In html the node it will take affect in depends on whether on not that 
> block is on it's own page.
> 
> In PDF you can only set draft at book or chapter levels.
> 
> I've had a look at the XSL and it's possible to get the HTML outputs to 
> behave as you'd expect, switch ON at the book/chapter/section level 
> regardless of it's position on the page. However the PDF is a different 
> story, it may not be possible to imitate this behaviour without 
> rewriting a large quantity of the default XSL.
> 
> How should we handle this? I'm tempted to leave the PDF in it's current 
> state and make the HTML outputs work properly. While this would make 
> drafting with the PDF less manageable than drafting with the HTML, it 
> will mean drafting gets fixed in the HTML a lot sooner.
> 
> Also I have been asked to add other status' to allow documentation to be 
> marked as beta/alpha/RC etc, this is easy in the HTML but requires the 
> same rewrite as for the beta status in the PDF.
> 
> All comments welcome.

No comments, so I guess this means I can do whatever I want! w00t!

Since I have only ever heard of draft used in the context of an entire document, I think that is all we should support.

One way to get a chapter or section reviewed is to add a remark to the title of the block saying to review it.

e.g.

<section>
	<title><remark>%% REVIEW ME %%</remark>Big section on sectioning sections</title>

This gets the remark in the TOC if you have remarks enabled, so it's pretty obvious to readers where to go to review. It's even highlighted!

I am still accepting comments!!!!!111

Cheers, Jeff.

-- 
Jeff Fearn <jfearn at redhat.com>
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY