[publican-list] RFC: Modified JBoss brand (was Re: RFE for Publican Brands)

Tue Oct 12 05:52:21 UTC 2010

I agree the position of the figure title is questionable. For example blocks, it certainly makes sense readability-wise for the titles to be at the top, while typically figure titles go underneath to act as a caption.

So it's a matter of either having the titles at the tops of both examples and figures for consistency, or having titles at the bottom of figures like it is in most other publications. I think I'm probably inclined towards the latter.

- Sean

----- "Misty Stanley-Jones" <misty at redhat.com> wrote:

| ----- "Andrew Ross" <anross at redhat.com> wrote:
| > Not so sure:
| >  - <figure> text above image
| 
| Extremely negotiable. I did it to be consistent with examples and
| procedures.
| 
| > 
| > No opinion either way:
| >  - greyscale on screen tags inside notes (which IIRC was orig
| issue)
| > 
| 
| The grey has been lightened considerably. It was dark grey almost
| black, making a lot of highlighted text inside programlistings
| unreadable.
| 
| Here is a list of everything I actually changed:
| 
| Admonitions: All have grey interior and white text, with thick
| color-coded borders.
| * Note: Dark grey border
| * Important: Orange border (same color as the whole box was before)
| * Warning: Red border (same color as the whole box was before)
| 
| Programlistings and screens: 
| *Light grey interior
| *Thin dark-grey border. 
| *Consistent throughout the document, alone or within examples or
| admonitions.
| 
| Examples: 
| *Dark green border
| *White inner div (so paragraphs are black on white, instead of black
| on bright orange), 
| *Title on top
| 
| Figures:
| *Title on top
| 
| 
| Misty
| 
| 
| > HTH,
| > 
| > Andrew
| > 
| > [1] IANAD - I am not a designer
| > 
| > > ----- misty at redhat.com wrote:
| > > 
| > > > From: misty at redhat.com
| > > > To: "Publican discussions" <publican-list at redhat.com>
| > > > Sent: Tuesday, October 12, 2010 3:14:44 PM GMT +10:00 Brisbane
| > > > Subject: [publican-list] RFC: Modified JBoss brand (was Re: RFE
| > for
| > > Publican Brands)
| > > >
| > > > I've modified the JBoss brand and attached the modified
| version.
| > > I'd
| > > > love it if some of you could build books using it and let me
| know
| > > what
| > > > you think. Extract it to /usr/share/publican/Common_Content and
| > > call
| > > > it from publican.cfg as JBoss-misty.
| > > > 
| > > > Just as the JBoss brand currently, the HTML versions do not
| > > currently
| > > > sync with the PDF version. I didn't put too much effort into it
| > > (yet),
| > > > because it obviously has not been a priority thus far. I'd like
| > to
| > > get
| > > > the changes synchronized to PDF, because I think they really
| help
| > > with
| > > > printing.
| > > > 
| > > > I've also included a .zip of a built book in HTML-single, so
| that
| > > you
| > > > can see it in action without having to build your own book.
| > > > 
| > > > If you get the Digest version of this mailing list and want to
| > see
| > > the
| > > > attachments, just ping me and I will send them to you
| > individually.
| > > > 
| > > > Thanks,
| > > > Misty
| > > > 
| > > > ----- "Jeffrey Fearn" <jfearn at redhat.com> wrote:
| > > > 
| > > > > From: "Jeffrey Fearn" <jfearn at redhat.com>
| > > > > To: "Publican discussions" <publican-list at redhat.com>
| > > > > Sent: Tuesday, October 12, 2010 9:04:56 AM GMT +10:00
| Brisbane
| > > > > Subject: Re: [publican-list] RFE for Publican Brands
| > > > >
| > > > > Darrin Mison wrote:
| > > > > > 
| > > > > > On Mon, 2010-10-11 at 16:31 +1000, Jeff Fearn wrote: 
| > > > > >> On Mon, 2010-10-11 at 02:13 -0400, Misty Stanley-Jones
| > wrote:
| > > > > >>> How do we go about getting someone in Middleware some
| > > > credibility?
| > > > > Surely it is not such a scarce commodity that it can't be
| > spread
| > > > > around a bit. I think we'd like a hand in the look and feel
| of
| > > our
| > > > > docs, if we can ever build up the credibility.
| > > > > >> Credibility is earned not given, who in Middleware will
| > stand
| > > up
| > > > > and
| > > > > >> earn some?
| > > > > >>
| > > > > >> How is it earned? I've never thought about it. It is an
| > > > > interesting
| > > > > >> question though, how does one earn credibility in a
| > > meritocracy?
| > > > > > 
| > > > > > AFAICT generally by contributing work, and having those
| with
| > > > > credibility
| > > > > > accept your work.  
| > > > > 
| > > > > Well true, but I would like to make sure we don't end up with
| a
| > 
| > > > > completely arbitrary environment, and the only way to do that
| > is
| > > to
| > > > > get 
| > > > > some processes or documentation in place about who to
| > contribute
| > > for
| > > > 
| > > > > different things.
| > > > > 
| > > > > e.g.
| > > > > 
| > > > > If you have recommendations for a brand then make a new
| brand,
| > > apply
| > > > 
| > > > > your changes, build a book, maybe a set book, with the new
| > brand
| > > and
| > > > 
| > > > > distribute for comment.
| > > > > 
| > > > > If you have a suggestion for better release documentation,
| make
| > a
| > > > page
| > > > > 
| > > > > on the wiki with an example of how it should be done. Maybe
| > pick
| > > an
| > > > 
| > > > > existing release and document that.
| > > > > 
| > > > > I'm sure there are heaps of other ways to contribute that
| > people
| > > > would
| > > > > 
| > > > > find easy to join in if we documented them.
| > > > > 
| > > > > Cheers, Jeff.
| > > > > 
| > > > > -- 
| > > > > Jeff Fearn <jfearn at redhat.com>
| > > > > Software Engineer
| > > > > Engineering Operations
| > > > > Red Hat, Inc
| > > > > Freedom ... courage ... Commitment ... ACCOUNTABILITY
| > > > > 
| > > > > _______________________________________________
| > > > > publican-list mailing list
| > > > > publican-list at redhat.com
| > > > > https://www.redhat.com/mailman/listinfo/publican-list
| > > > > Wiki: https://fedorahosted.org/publican
| > > > 
| > > > -- 
| > > > Misty Stanley-Jones
| > > > Content Author, ECS Brisbane
| > > > Ph: +61 7 3514 8105
| > > > RHCT #60501081553354
| > > > Purgamentum init, exit purgamentum.
| > > > 
| > > > _______________________________________________
| > > > publican-list mailing list
| > > > publican-list at redhat.com
| > > > https://www.redhat.com/mailman/listinfo/publican-list
| > > > Wiki: https://fedorahosted.org/publican
| > > 
| > > -- 
| > > Misty Stanley-Jones
| > > Content Author, ECS Brisbane
| > > Ph: +61 7 3514 8105
| > > RHCT #60501081553354
| > > Purgamentum init, exit purgamentum.
| > > 
| > > _______________________________________________
| > > publican-list mailing list
| > > publican-list at redhat.com
| > > https://www.redhat.com/mailman/listinfo/publican-list
| > > Wiki: https://fedorahosted.org/publican
| > 
| > -- 
| > 
| > Andrew Ross
| > Quality Engineer, Content Services
| > RHCE
| > Red Hat Asia Pacific
| > Phone: 3514 8331
| > E-mail: anross at redhat.com
| > 
| > 
| > "Commander Cody, the time has come. Execute Order 66." - Darth
| Sidious
| > Ep.III
| > 
| > _______________________________________________
| > publican-list mailing list
| > publican-list at redhat.com
| > https://www.redhat.com/mailman/listinfo/publican-list
| > Wiki: https://fedorahosted.org/publican
| 
| -- 
| Misty Stanley-Jones
| Content Author, ECS Brisbane
| Ph: +61 7 3514 8105
| RHCT #60501081553354
| Purgamentum init, exit purgamentum.
| 
| _______________________________________________
| publican-list mailing list
| publican-list at redhat.com
| https://www.redhat.com/mailman/listinfo/publican-list
| Wiki: https://fedorahosted.org/publican