[publican-list] RFC: Supporting RevisionFlag attribute

Mike Hideo mhideo at redhat.com
Thu May 6 02:04:50 UTC 2010


On 05/05/2010 10:47 AM, Jeffrey Fearn wrote:
> Currently RevisionFlag isn't used by Publican, I think it can be used to
> aid reviewing documentation.
>
> http://www.docbook.org/tdg/en/html/ref-elements.html#common.attributes
>
> The idea being that when an author modifies a book, they set the
> RevisionFlag and if the book is in draft mode then Publican would
> highlight that tag.
>
> e.g.
>
> RevisionFlag="Changed" might have a yellow background.
> RevisionFlag="Added" might have a green background.
> RevisionFlag="Deleted" might have strike through applied.
>
> This way reviewers would get visual queues about what has happened at
> the tag level.
>
> It probably makes sense to only use this at the block level, para etc,
> but I don't see any reason to enforce that usage.
>
> When the book is ready for release, the tags marked as Deleted would
> need to be deleted by the author, and the remaining RevisionFlag
> attributes would need to be set to Off, or deleted.
>
> To aid usability we could be new action to delete all RevisionFlag
> attributes.
>
> e.g. $ publican clear_rev_flags
>
> Discuss!

Hi Jeff,

This would be extremely useful for our SME's and our QE counterparts. A 
really great idea. Though not nearly a great idea as:

http://www.dailyhaha.com/_pics/bacon-suit.jpg but pretty close.

- Mike




More information about the publican-list mailing list