Re: [boost] Customer Friendlier Boost Installation -- (Finally) Getting Started

From: Rob Stewart (stewart_at_[hidden])
Date: 2005-06-21 15:03:57

From: Rene Rivera <grafik.list_at_[hidden]>
> Rob Stewart wrote:
> > From: Rene Rivera <grafik.list_at_[hidden]>
> >>Rob Stewart wrote:
> >>>
> >>>Consider avoiding the passive "it is strongly recommended."  I
> >>>suggest this:
> >>>
> >>>   You should <a href="...">download a prebuilt bjam
> >>>   executable</a> if we have supplied one for your platform....
> >>
> >>Or similarly to something that changes the meaning less:
> >>
> >>   We strongly recommend that you simply <a href="...">download a
> >>   [etc.]
> > 
> > I don't see that mine changed the meaning.  Sure, I omitted
> > "strongly recommend," but this is a Getting Started guide, so
> > anything not equivocated should be taken as explicit
> > direction. Only the reader with enough familiarity to not require
> > the Getting Started guide will know enough to choose another
> > course.
> 
> Sure :-) I was just pointing out the different, although subtle, change 
> in tone of the statement.

OK

> > Also, I suspect -- I haven't confirmed this -- that "we" isn't
> > used elsewhere.  Thus, I think your version would need to be
> > "Boost strongly recommends...."
> 
> That's funny ;-) Given that the same sentence we are talking about has 
> "... if _we_ have supplied ...".

Doh!  I told you I hadn't confirmed it!

-- 
Rob Stewart                           stewart_at_[hidden]
Software Engineer                     http://www.sig.com
Susquehanna International Group, LLP  using std::disclaimer;