API Documentation about devalpha-node HOT 6 CLOSED

I think the last time I had a look at it, I didn't find any nice tool for TypeScript API docs generation. I'll try and look into it some more to see if I can find a good option.

Also, thanks a bunch for your input - really appreciated!

from devalpha-node.

Thanks for the kind words.

I understand it can take more effort to select and integrate and learn a tool than you get out of it. In this situation I'll manually make up Markdown tables for my own reference. If they're useful to anybody else, so much the better. I'll probably badger you to fill in some essential holes. :)

(Probably a day or two before I'll have time to work up the tables).

from devalpha-node.

I made a go, but Markdown isn't up to the task. I'll think about writing it in JCreole and posting to my own site. JCreole is a wikitext engine I wrote some years back and it supports cell spanning, nesting code blocks within cells, etc. Or maybe I'll bit the bullet, learn an API-generating tool and post the output on my own site. Enough time spent on documentation today though.

from devalpha-node.

I tried jsdoc, but it's not up to the task. It doesn't recurse enough to be useful. For example, it sees that the strategy param to createTrader is a Strategy, but it can't build docs for createStrategy.js.

Guess I'll probably document this with JCreole, but now I'm working on strategies that use ticker/Time&Sales events instead of bars as input, so using my own driver. (Since the DevAlpha dashboard only works with OHLC/candlestick-like timeslice inputs).

from devalpha-node.

I'm currently looking into if it is possible to leverage Documentalist. Will keep you posted on the progress!

from devalpha-node.

Documentalist proved to be even less mature than Typedoc, so I gave Typedoc one more chance. An API reference for devalpha-node can now be found at https://devalpha-io.github.io/website/api/. Enjoy!

from devalpha-node.