David Abrahams wrote:
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.
Sorry, I don't quite understand. What's the reason for a
difference?
That there will be pressure to keep the BoostBook pages looking as
they are. If we say that all the pages should be styled the same way
and nobody is willing to change the BoostBook pages, it inhibits
Rene's ability to do something different (IMO better) for the website
at large.
I fear this. More on this below...
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.
I could have said the same thing with the Spirit docs
as they were. But where does that leave us? I bit the bullet
and chose to follow whatever comes out of discussion over
L&F at the time it was being deliberated. What has been done
was a fair amount of discussion, tweak, discussion, tweak
to move us closer to something that was supposedly agreeable
to most.
But you were already using BoostBook, or at least QuickBook, at that
time, n'est-ce-pas? I have no BoostBook docs yet.
No, Spirit's docs were written prior to QuickDoc (QuickBook's
predescesor). Phoenix-1 was written using QuickDoc using the L&F
of the original Spirit docs. I was agreeable to the idea of a
common L&F for the docs, hence, when QuickBook was developed,
I tried to be as active as I can on the discussions, hopefully
to have an agreed upon L&F that I can migrate to. And so I
did with Phoenix-2 and Fusion, then later, Spirit-2.
I certainly didn't like many of what has come out of the consensus,
but it was consensus none the less. Were all those in vain?
No, I don't think so.
If so, then there's really no point in continuing this
discussion. Maybe we should just let it be and let each author
choose his own L&F just as, say, W3C does (there's no commom L&F,
each document has its own style).
Bad idea, I think.
Ok... well, I took a few days off the topic; thinking that maybe
I might have a better understanding and change of heart after
a while. Now, after thinking about it some more, I think my
greatest apprehension stems from the feeling that Rene's L&F
is being forced unto me. It gives me the same feeling when I
was in school (an Italian, all boys, school) where we all had to
wear the same uniform, same haircut, same everything. I think
the lack of color (you can have any color as long as it's black)
also contributed to this feeling, especially when Reece mentioned
Schindler's list. It evokes in me the same feeling of Nazi style
control and the holocaust or the borg or a dark penal colony
in a planet somewhere in the 3050AD.
The docs are works of various authors. They should have control
over the L&F. I am 100% for uniformity, but it should not be
*forced* uniformity. It should be something that we agree on.
That said, in the spirit of cooperation and team work,
I'll withdraw my current objections and accept Rene's work
and recommend that the current QuickBook L&F be modified to
come closer to Rene's. Indeed, Rene's current version looks very
professional. Is it the best? No, it is not. To be honest, I
prefer the wikipedia style. I remember Daniel Wallin showed
me something like it and I liked it a lot. However, given
that eveyone now seems to be gravitating towards Rene's,
and considering the amount of time spent on it, I'd give it
my approval (FWIW).
At it's current state, and conceding details, I have only one
strong objection left: the links. Please retain the current
QuickBook link style. It's the same as the wikipedia style.
It works, it is less distracting and it is pleasing to see,
and, you don't need to have it differently for the table of
contents, code and general links in the content.
Regards,
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
-------------------------------------------------------
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
