Rene Rivera wrote:
Joel de Guzman wrote:
Rene Rivera wrote:
More questions...
Did not the various discussions and consensus to move to BoostBook
docs imply a consent to be at the mercy of the BoostBook style?
If not, do we want to get that consensus now?
Those who are using BoostBook already imply acceptance of its
L&F.
But I would think that doesn't mean that they imply acceptance into
changing that design.
Yes. We should be careful in that regard.
That's quite significant, as it stands today. From the
moment it took off from Doug's initial work, then the various
discussions, on and off, then QuickBook, etc. It's
already taken many man-hours of work from us all.
Yep, including some of mine. But my personal worry in this regard is the
loss of effectiveness, and hence of my personal effort and time, of a
redesigned website if it's going to be "subverted" by the dueling doc
designs. This in effect is, equivalent, but mirror of your concerns
about library author doc design.
If you and Dave say that it's not too far in the POV of L&F
then why worry? One thing I learned from this process is that
you can never be a purist and after a while, the impurity
actually grows on you. It's like C++ ;)
That is
why I am so adamant to not let it go and be replaced, instead
evolve it, incrementally, with proper consultation.
Sure, and speaking of that no one has commented on my proposed process
for driving that consultation and evolution I posted at the top of the
thread.
Ahem. I guess you know where I stand. So, I'm also waiting
for other people to jump in.
If there's no chance of getting such an agreement; Why should we
bother with presenting the docs on the website at all?
That's my apprehension all along. It can't simply be a majority
vote. All authors must agree. We can't realistically do that
overnight. Again, it's evolution, not revolution.
I'm not sure how realistic having agreement from all authors is. It
wasn't possible for the license changes. So I can't think it would be
different for this situation. At some point we have to choose to
progress the public image of Boost irrespective of what some authors
say, or not say. Right? Otherwise it would seem we would need the
approval of every author to change any common aspect of Boost.
No, I don't think so. There were clear guidelines as to
how boost operates. The power to change the docs in any way
is not one of them. Each library is the jurisdiction of its
author and the parts therein are sacred. How would you feel
if someone comes along, and with "progress" in mind, changes
the layouting of your code to a common layout (indents, etc)
for all of boost? No, we can't do that. Instead, we can only
provide layout guidelines.
OTOH, there are parts in boost which are clearly owned by the
boost owners. Those do not need approval to change.
Do we want to live with presenting the docs in the website with the
authors style? And hence have limited potential functionality, i.e.
no web notes.
IMO, there's no other way at this point in time.
Perhaps.
Have you
ever wondered why the W3C docs do not have a common L&F after
all the years, for example?
No :-) The limited set of docs I read on a daily basis, the web related
standards, all use essentially the same style.
Go on, take a peek at their docs: http://www.w3.org/. It's a
multitude of styles. Yet, that does not make W3C any less
"professional".
It's unlike, say, wikipedia, for example, where there is a common
L&F. The reason is because wikipedia, from its inception, used
its content management tool (wiki) which has its own L&F.
Anyone contributing to it implies acceptance of the L&F.
IMO, BoostBook and QuickBook is our ticket to that.
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
