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

Tue Oct 12 05:44:10 UTC 2010

----- "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.