Improve documentation #306
Description
I was look at iota.lib.js and seems they have a pretty detailed and structured documentation: https://github.com/iotaledger/iota.lib.js/tree/next/packages/core#module_core.storeTransactions.
Even though we do have a doxygen, it is not as much detailed as theirs.
I guess we can spend some time improving our documentation by learning from them.