-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Edward Diener via Boost Sent: 28 September 2017 16:21 To: boost@lists.boost.org Cc: Edward Diener Subject: Re: [boost] [ANN] Boost.UI - a new C++ GUI library
On 9/28/2017 9:20 AM, Kolya Kosenko via Boost wrote:
There is no details in documentation because it is just first public announce and many things could be changed.
That's fine, but it isn't enough to be accepted as a Boost library - yet.
It is precisely the details of what concepts your library implements that will attract interested end-users.
I do not mean to sound harsh or not be encouraging, but Boost libraries try to explain what they are about and are not documented only as a list of classes and a set of code examples.
I'd be very encouraging. I suspect it meets a number of people's needs (if niche as you say).
From a quick view of the documentation, I felt I needed a tutorial to get me started.
You've got an excellent set of examples (and examples are often the most useful to novice users). You might build on those examples by some text that refers (using links) to many of the examples explaining how/what they show. Despite its good documenting of functions, class etc, the end results from Doxygen are generally very unpopular with users (often having been bitten by the deluded who think that just feeding the code into is 'job done'). You haven't made this mistake, using the Doxygen syntax to document functions, class etc., and also using the text facilities to provide some text. You could consider using Quickbook etc. toolchain that is popular with Boost libraries and users, but that's quite a big job unless you are sure that you have a user base. Ask me if you want to start on this as I can probably make the learning curve less precipitous ;-) Good luck. Paul --- Paul A. Bristow Prizet Farmhouse Kendal UK LA8 8AB +44 (0) 1539 561830