News for hackers. Stuff that matters.

A comment on Fatal: A library for fast prototyping of software in C++11 and up.

Re:Fatal: A library for fast prototyping of software in C++1... by doomrobo on Wednesday September 10, 2014 @09:10PM (#8300324)
> Extensive documentation with examples can be found inline in the source header files.

I don't see this as a proper way to do docs. At least give a first-time viewer a glimpse of what this might be useful for. I'm completely in the dark, myself.

[ Parent | on HN ]
Re:Fatal: A library for fast prototyping of software in C++1... by cledet on Wednesday September 10, 2014 @09:54PM (#8300457)
Don't worry. They will abandon it in a few weeks because they rewrote a new one that works better.
[ Parent | on HN ]
Re:Fatal: A library for fast prototyping of software in C++1... by lstamour on Wednesday September 10, 2014 @11:08PM (#8300670)
Check the sides. As for header docs, they do seem extensive: https://github.com/facebook/fatal/blob/master/fatal/type/pre...
[ Parent | on HN ]
Re:Fatal: A library for fast prototyping of software in C++1... by wallstop on Wednesday September 10, 2014 @09:46PM (#8300439)
Agreed. However, it's still viable to go that route if you have a document-generating tool like doxygen that will pull all of this data out and make a (rather hideous, but usable) bunch of html documentation.

This is not an example of that.

[ Parent | on HN ]