Subject: Re: Re: *Attention* opinions needed on release documentation - msg#00006
List: lib.boost.documentation
Eric Niebler wrote:
Joel wrote:
Aleksey Gurtovoy wrote:
David Abrahams writes:
"Eric Niebler" <eric@xxxxxxxxxxxxxxxxxxxx> writes:
3) Do nothing. Live with the inconsistency.
That one. There's always been some inconsistency in the Boost docs;
this is nothing new and we can solve it for the next release.
FWIW, IMO the *degree* of it is new and somewhat disturbing. I'd
prefer to see it fixed, since it's only a single CSS tweak.
I would prefer to go that route. It will be hairy, I know. I'm afraid
that a "bicycle shed" debate will ensue and will last a long time, but
let it be settled once and for all.
By "that route" do you mean "do nothing" or "CSS tweak" ?
3) Do nothing. Live with the inconsistency.
Plus: Start encouraging people to port their docs to Boostbook or
at least use the new L&F CSS now. Check in the new CSS now.
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
-------------------------------------------------------
This SF.Net email is sponsored by:
Sybase ASE Linux Express Edition - download now for FREE
LinuxWorld Reader's Choice Award Winner for best database on Linux.
http://ads.osdn.com/?ad_id=5588&alloc_id=12065&op=click
_______________________________________________
Boost-docs mailing list
Boost-docs@xxxxxxxxxxxxxxxxxxxxx
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
Was this page helpful?
Thread at a glance:
Previous Message by Date:
click to view message preview
Re: Re: *Attention* opinions needed on release documentation
Joel wrote:
Aleksey Gurtovoy wrote:
David Abrahams writes:
"Eric Niebler" <eric@xxxxxxxxxxxxxxxxxxxx> writes:
3) Do nothing. Live with the inconsistency.
That one. There's always been some inconsistency in the Boost docs;
this is nothing new and we can solve it for the next release.
FWIW, IMO the *degree* of it is new and somewhat disturbing. I'd
prefer to see it fixed, since it's only a single CSS tweak.
I would prefer to go that route. It will be hairy, I know. I'm afraid
that a "bicycle shed" debate will ensue and will last a long time, but
let it be settled once and for all.
By "that route" do you mean "do nothing" or "CSS tweak" ?
--
Eric Niebler
Boost Consulting
www.boost-consulting.com
-------------------------------------------------------
This SF.Net email is sponsored by:
Sybase ASE Linux Express Edition - download now for FREE
LinuxWorld Reader's Choice Award Winner for best database on Linux.
http://ads.osdn.com/?ad_id=5588&alloc_id=12065&op=click
_______________________________________________
Boost-docs mailing list
Boost-docs@xxxxxxxxxxxxxxxxxxxxx
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
Next Message by Date:
click to view message preview
Re: Re: *Attention* opinions needed on release documentation
Joel writes:
> Eric Niebler wrote:
>
> > Joel wrote:
> >
> >> Aleksey Gurtovoy wrote:
> >>
> >>> David Abrahams writes:
> >>>
> >>>> "Eric Niebler" <eric@xxxxxxxxxxxxxxxxxxxx> writes:
> >>>>
> >>>>
> >>>>> 3) Do nothing. Live with the inconsistency.
> >>>>
> >>>>
> >>>>
> >>>> That one. There's always been some inconsistency in the Boost docs;
> >>>> this is nothing new and we can solve it for the next release.
> >>>
> >>>
> >>>
> >>>
> >>> FWIW, IMO the *degree* of it is new and somewhat disturbing. I'd
> >>> prefer to see it fixed, since it's only a single CSS tweak.
> >>
> >>
> >>
> >> I would prefer to go that route. It will be hairy, I know. I'm afraid
> >> that a "bicycle shed" debate will ensue and will last a long time, but
> >> let it be settled once and for all.
> >>
> >
> > By "that route" do you mean "do nothing" or "CSS tweak" ?
>
> 3) Do nothing. Live with the inconsistency.
I don't know. It feels like we are being extreme without a reason. If we can,
for the time being, in the release branch, by commenting two lines of CSS
code, make the docs look *significantly* more uniform (and still good
looking), why not do it?
>
> Plus: Start encouraging people to port their docs to Boostbook or
> at least use the new L&F CSS now. Check in the new CSS now.
It's in already.
--
Aleksey Gurtovoy
MetaCommunications Engineering
-------------------------------------------------------
This SF.Net email is sponsored by:
Sybase ASE Linux Express Edition - download now for FREE
LinuxWorld Reader's Choice Award Winner for best database on Linux.
http://ads.osdn.com/?ad_id=5588&alloc_id=12065&op=click
_______________________________________________
Boost-docs mailing list
Boost-docs@xxxxxxxxxxxxxxxxxxxxx
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
Previous Message by Thread:
click to view message preview
Re: Re: *Attention* opinions needed on release documentation
Joel wrote:
Aleksey Gurtovoy wrote:
David Abrahams writes:
"Eric Niebler" <eric@xxxxxxxxxxxxxxxxxxxx> writes:
3) Do nothing. Live with the inconsistency.
That one. There's always been some inconsistency in the Boost docs;
this is nothing new and we can solve it for the next release.
FWIW, IMO the *degree* of it is new and somewhat disturbing. I'd
prefer to see it fixed, since it's only a single CSS tweak.
I would prefer to go that route. It will be hairy, I know. I'm afraid
that a "bicycle shed" debate will ensue and will last a long time, but
let it be settled once and for all.
By "that route" do you mean "do nothing" or "CSS tweak" ?
--
Eric Niebler
Boost Consulting
www.boost-consulting.com
-------------------------------------------------------
This SF.Net email is sponsored by:
Sybase ASE Linux Express Edition - download now for FREE
LinuxWorld Reader's Choice Award Winner for best database on Linux.
http://ads.osdn.com/?ad_id=5588&alloc_id=12065&op=click
_______________________________________________
Boost-docs mailing list
Boost-docs@xxxxxxxxxxxxxxxxxxxxx
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
Next Message by Thread:
click to view message preview
Re: Re: *Attention* opinions needed on release documentation
Joel writes:
> Eric Niebler wrote:
>
> > Joel wrote:
> >
> >> Aleksey Gurtovoy wrote:
> >>
> >>> David Abrahams writes:
> >>>
> >>>> "Eric Niebler" <eric@xxxxxxxxxxxxxxxxxxxx> writes:
> >>>>
> >>>>
> >>>>> 3) Do nothing. Live with the inconsistency.
> >>>>
> >>>>
> >>>>
> >>>> That one. There's always been some inconsistency in the Boost docs;
> >>>> this is nothing new and we can solve it for the next release.
> >>>
> >>>
> >>>
> >>>
> >>> FWIW, IMO the *degree* of it is new and somewhat disturbing. I'd
> >>> prefer to see it fixed, since it's only a single CSS tweak.
> >>
> >>
> >>
> >> I would prefer to go that route. It will be hairy, I know. I'm afraid
> >> that a "bicycle shed" debate will ensue and will last a long time, but
> >> let it be settled once and for all.
> >>
> >
> > By "that route" do you mean "do nothing" or "CSS tweak" ?
>
> 3) Do nothing. Live with the inconsistency.
I don't know. It feels like we are being extreme without a reason. If we can,
for the time being, in the release branch, by commenting two lines of CSS
code, make the docs look *significantly* more uniform (and still good
looking), why not do it?
>
> Plus: Start encouraging people to port their docs to Boostbook or
> at least use the new L&F CSS now. Check in the new CSS now.
It's in already.
--
Aleksey Gurtovoy
MetaCommunications Engineering
-------------------------------------------------------
This SF.Net email is sponsored by:
Sybase ASE Linux Express Edition - download now for FREE
LinuxWorld Reader's Choice Award Winner for best database on Linux.
http://ads.osdn.com/?ad_id=5588&alloc_id=12065&op=click
_______________________________________________
Boost-docs mailing list
Boost-docs@xxxxxxxxxxxxxxxxxxxxx
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs