Re: [boost] Call for Review: Boost.Test documentation rewrite

Subject: Re: [boost] Call for Review: Boost.Test documentation rewrite
From: Alexander Lamaison (awl03_at_[hidden])
Date: 2014-01-17 10:42:01

Gennadiy Rozental <rogeeff_at_[hidden]> writes:

> Paul A. Bristow <pbristow <at> hetp.u-net.com> writes:

>> and it's what I use for everyday
>> work, and I'm sure I am not the only one doing this.  So I'd like 
>> to see Richard's documentation of the current release Boost.Test adopted
>> now.
>
> And I'd like to see a documentation which covers full library, not part of 
> it. And the one which covers latest state of the library, not the version 
> from 5 years ago.

It's not the version from 5 years ago; it's the version in the latest
release today!  I don't know why you keep insisting otherwise.

Sure, the trunk may have had new changes for X years, but the trunk is
never released.  Until your version is merged to release it remains the
version of tomorrow, not today.

> What about next release? Do you think it is a good practice if we release 
> these docs now and then something completely different half a year
> later?

Absolutely.  The docs should be the best available documentation for the
code that ends up in the release.  When the new version ends up there,
then we update the docs to match.

Alex

-- 
Swish - Easy SFTP for Windows Explorer (http://www.swish-sftp.org)