Re: [boost] [Boost-users] [afio] Formal review of Boost.AFIO

Subject: Re: [boost] [Boost-users] [afio] Formal review of Boost.AFIO
From: Niall Douglas (s_sourceforge_at_[hidden])
Date: 2015-08-25 10:08:29

On 25 Aug 2015 at 12:37, Paul A. Bristow wrote:

> 1. Should Boost.AFIO be accepted into Boost? Please state all 
>    conditions for acceptance explicity. 
>  
> Provisionally, yes. 
>  
> Requirements:
>  
> .        Major restructuring of documentation. (Not re-writing!)
>  
> .        Completion of Boost.Was_Called_Monad and APBind.
>  
> .        Creation of a TODO list.
> 
> .        Mini-review before going into a release (perhaps of all together?).
> 
> .        More documentation of examples to explain what they demonstrate.

Thanks for the review Paul. I pretty much agree with all of it.

This review process has been particularly useful for helping me see 
the documentation as others see it - I had no idea it was so 
confusing! - and I'm going to try raising with the Standard C++ 
Foundation in Seattle next month the idea of them funding 
professional copy writers to take passes at C++ library 
documentation.

Niall

-- 
ned Productions Limited Consulting
http://www.nedproductions.biz/ 
http://ie.linkedin.com/in/nialldouglas/