On 7 Aug 2015 at 22:18, Glen Fernandes wrote:
all the stuff from https://svn.boost.org/trac/boost/wiki/BestPracticeHandbook.
The items listed in https://svn.boost.org/trac/boost/wiki/BestPracticeHandbook do not represent any official boost policy nor have they been discussed such that they represent any consensus. So though they may be relevant to Nail's recommendation, they may not be relevant to anyone else's.
+1
+1. I'm not really sure why a page called "BestPracticeHandbook" that lives on http://*.boost.org/* exists when it is not a "Best practice handbook" and not anything that the Boost community agrees upon or even acknowledges.
It's a wiki document. Anyone with a Trac login can edit it. If you feel anything in there is technically wrong, fix it. If you feel anything in there shouldn't be in there, raise the issue here and if there is consensus it shouldn't be in there, we'll delete it. I would also add that library authors will pick and choose from the handbook as they see fit. It's not a gospel, nor claims to be one. The key thing Boost needed was a library development resource guide as we had little which was up to date and especially relevant to C++ 11/14. I wrote my personal vision of that, as I was the one who invested the 120 hours or so of my family time to write it and I think that investment of my time gave me that right for the first edition. If you, or anyone else being critical of my substantial effort invested here, would like to write something better then go ahead and do it instead of +1 attacking it when you haven't done anything better yourself. But I'd prefer if it evolves into something more consensual, and as I mentioned everybody has editing rights. That indeed was the original intent - to get the ball rolling on some new shared documentation, as nobody was investing the effort to improve Boost documentation at that level in recent years. You may note each section in the wiki document has a comments section in which people can ask questions, or point out mistakes or otherwise give feedback per-section. That feedback system has already proven useful in substantially improving some of the sections in the guide where what I wrote was technically wrong, confusing or unclear, so I guess some people are finding the Handbook useful. Niall -- ned Productions Limited Consulting http://www.nedproductions.biz/ http://ie.linkedin.com/in/nialldouglas/