Re: [boost] [review] Review of PolyCollection starts today (May 3rd)

Subject: Re: [boost] [review] Review of PolyCollection starts today (May 3rd)
From: Edward Diener (eldiener_at_[hidden])
Date: 2017-05-06 03:53:20

On 5/2/2017 7:46 PM, Ion Gaztañaga via Boost wrote:
> Hi everyone,
> 
> The formal review of Joaquín M. López Muñoz's PolyCollection library 
> starts today.
> 
> I'd like to encourage your participation as the proposed library is 
> small and focused, and reviewers don't need to be domain experts to 
> appreciate the potential usefulness of the library and propose 
> improvements.
> 
> PolyCollection implements fast containers of polymorphic objects. 
> Typically, polymorphic objects cannot be stored directly in regular 
> containers and need be accessed through an indirection pointer, which 
> introduces performance problems related to CPU caching and branch 
> prediction. Boost.PolyCollection implements a novel data structure that 
> is able to contiguously store polymorphic objects without such 
> indirection, thus providing a value-semantics user interface and better 
> performance. Three polymorphic collections are provided:
> 
> * boost::base_collection
> * boost::function_collection

I could not understand from the documentation what it is I am supposed 
to be inserting into a function_collection. The tutorial did not explain 
this to me and the reference's technical explanation on this eluded me.

As usual the tutorial-reference form of documentation befuddles me 
whereas a simple explanation of the main topics of a library would 
probably make it easy for me to understand a library.

> * boost::any_collection
> 
> dealing respectively with classic base/derived or OOP polymorphism, 
> function wrapping in the spirit of std::function and so-called duck 
> typing as implemented by Boost.TypeErasure.
> 
> The library can be found here:
> 
>   Incubator:
>    http://blincubator.com/bi_library/polycollection/?gform_post_id=1643
> 
>   Github:
>    https://github.com/joaquintides/poly_collection
> 
> and the documentation here:
> 
> http://rawgit.com/joaquintides/poly_collection/website/doc/html/index.html
> 
> Please post your comments and review to the boost mailing list 
> (preferably), the Boost Library Incubator. or privately to the Review 
> Manager (to me ;-). Here are some questions you might want to answer in 
> your review:
> 
> - What is your evaluation of the design?
> 
> - What is your evaluation of the implementation?
> 
> - What is your evaluation of the documentation?
> 
> - What is your evaluation of the potential usefulness of the library?
> 
> - Did you try to use the library? With what compiler? Did you have any 
> problems?
> 
> - How much effort did you put into your evaluation? A glance? A quick 
> reading? In-depth study?
> 
> - Are you knowledgeable about the problem domain?
> 
> And most importantly:
> 
> - Do you think the library should be accepted as a Boost library?
> 
> For more information about Boost Formal Review Process, see: 
> http://www.boost.org/community/reviews.html
> 
> Waiting your reviews!