apidocs

http://apidocjs.com/

MIT licensed documentation page generator similar to doxygen but with focus on documenting the api calls.
It is currently being implemented by eos between other exchanges with api access. it will provide new developers a familiar and clean api website.

there are other options around like: https://github.com/lord/slate

apidocs is easy to use (example generated very quick: http://open-explorer.io/apidoc/) but we need to add specially formatted comments of the calls into the cpp files.
as our `database_api.cpp` and `api.cpp` are already big i also propose to refactor and split in different files by groups just as `account_api.cpp`, `objects_api.cpp` and so on.
this will make some progress in: https://github.com/bitshares/bitshares-core/issues/95

i didn't checked how hard it will be to separate the apis into files without breaking anything or what will be the best approach.

suggestions welcome.