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.
> > 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;
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk