Joel de Guzman <[EMAIL PROTECTED]> writes: > Hi, > > I still don't understand why there needs to be a difference > between the L&F of the "standalone" documentation and the "web" > based documentation. Is there a rationale?
Good question. I really liked what I saw in the Boost doc pages (e.g. Python's) that had been transformed by Rene's work. > If we are going for uniformity, then we should definitely strive > for a common L&F for both the "standalone" and "web" docs. I'd > say there are lots of good designs found in Rene's rendition but > it's too big a departure from the BoostBook L&F that we have > worked hard on to reach it's current form. I disagree, though I might be convinced otherwise. I think Rene's looks more professional and accessible. > Sure, it's not perfect, but it's the result of endless discussion on > this list and the boost list as well. While I welcome improvement > tweaks here and there, I'd be sad if we'll just throw away the work > done so far. > > I'm hoping we'll reach an agreement somewhere around the bend. > Perhaps the current BoostBook scheme can incorporate some of the > good aspects of Rene's design, subject to deliberation and > discussion, of course. In that case, there's your reason for a difference. And I guess I'll be keeping my docs out of BoostBook until the formatting looks as good to me as what we get on the site. The incentive to change just isn't there. > But I'd argue that this should be done on a per aspect basis; > otherwise we get overwhelmed. I'll try to collect my thoughts and > initiate a per-aspect discussion. I'll be constructive. I'll focus > on the good aspects that I wish to be incorporated into the current > BoostBook CSS. > > The top section: > > I think we are all in agreement here. It's a big departure from > the old. While I prefer color (e.g. Spirit's new top section > http://spirit.sf.net/), the backdrop is not bad. The tabbed like > links (Welcome, Intro, etc.) is also really nice. I agree that having a little color is a really nice thing. And Spirit's banner is beautiful. > Font Sizes: > > I prefer Rene's choice of font sizes over those we have in the > BoostBook scheme. I think the current ones we have are too big. > They work well for the headings, paragraphs and the code. I think > Rene's choice is just perfect for my taste. Agreed. > Code Boxes: > > I like Rene's code boxes. The line and the gray background shade > of gray, its indentation and margin, sits perfectly for my taste. > They are a perfect fit for Rene's choice of font sizes. Agreed. > EM, STRONG, CITE, DFN, CODE, > SAMP, KBD, VAR, ABBR, ACRONYM, > Q, SUB and SUP, INS and DEL: > > Perfect! Nuff said :) Agreed. These are the major things that make me like Rene's style better. The other issues are less crucial. > Notes: > > A splendid idea! While this may only be available for the web > version, I think it is a very good idea. > > ... > > Ok, I hope that's a good set of request for change. There are > certainly things I do not like (e.g. underlined links, I'm still trying to decide which of those link styles I think is more distracting. I think there are no really *good* solutions for link styles. They're all compromises. > + bullets, Those have been scrapped by agreement already. > bullets on the table of contents, Agreed; less is more. > choice (or lack) of color, That's a cultural thing to some extent. The Brazilian guys who work as painters up here in New England sometimes ruffle feathers when there's a miscommunication about color choices. It always comes out way too bright for the local taste. > etc.) but as I said, I wish to be constructive and start with > what I find agreeable. The idea is to discuss these aspects for > incorporation back to BoostBook's CSS. There may be more later. > Then, we'll deal with them as they come. I think we should have that discussion regardless. -- Dave Abrahams Boost Consulting www.boost-consulting.com ------------------------------------------------------- This SF.net email is sponsored by: Splunk Inc. Do you grep through log files for problems? Stop! Download the new AJAX search engine that makes searching your log files as easy as surfing the web. DOWNLOAD SPLUNK! http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642 _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
