From: Rene Rivera <grafik.list@redshift-software.com>
Rob Stewart wrote:
From: Rene Rivera <grafik.list@redshift-software.com>
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@sig.com Software Engineer http://www.sig.com Susquehanna International Group, LLP using std::disclaimer;