Ruediger Landmann wrote:
On 12/04/2009 08:11 AM, Jeffrey Fearn wrote:
I'd drop the revision history, shorten the legal notice, and move the
copyright and legal link to the top. I'd also just use the license
acronym as a link to the upstream text.
e.g.
Copyright © 2009 Red Hat, Inc. and others. CC-BY-SA
Where CC-BY-SA is a link to
http://creativecommons.org/licenses/by-sa/3.0/
OK -- I've streamlined the author and copyright/licensing information
even further, per your suggestions.
However, I did still keep a last (further reduced) vestige of the
Revision History at the foot of the document; I think that for technical
writing, it's important to identify this revision somehow so that when
an article ends up republished in a number of places, people can readily
identify which version is the more recent. Actually -- discussions of
article formatting aside, I think that including the version number in
the header could be a useful addition to Publican's HTML output... but
that's probably another post :)
Also -- would it be possible to allow the abstract to be switched on and
off? An abstract is a normal feature in a tech report or journal
article, but not so well suited to a how-to (like this example) or, say,
a product sheet.
This is what the class attribute is for ... I thought we were talking
about what the default article should look like?
Cheers, Jeff.
--
Jeff Fearn <jfe...@redhat.com>
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY
_______________________________________________
publican-list mailing list
publican-list@redhat.com
https://www.redhat.com/mailman/listinfo/publican-list
Wiki: https://fedorahosted.org/publican
