Take the 2-minute tour ×
Programmers Stack Exchange is a question and answer site for professional programmers interested in conceptual questions about software development. It's 100% free, no registration required.

my question is rather short:

How do I document typescript code properly? I found out that for projects becoming bigger and bigger, it is important to look at a function and immediately know parameters, what it returns and side-effects etc. It is tiring to have just a bunch of comments before a function, most of the time these 'blocks' even look differently in style. What I am looking for is a documentation tool like javadoc or doxygen for typescript. Is there anything out there? Or is it possible to 'abuse' a documentation tool and get it to work with typescript?

share|improve this question

closed as off-topic by gnat, MichaelT, Bart van Ingen Schenau, GlenH7, Michael Kohne Dec 24 '13 at 21:38

This question appears to be off-topic. The users who voted to close gave this specific reason:

  • "Questions asking us to recommend a tool, library or favorite off-site resource are off-topic for Programmers as they tend to attract opinionated answers and spam. Instead, describe the problem and what has been done so far to solve it." – gnat, MichaelT, Bart van Ingen Schenau, GlenH7, Michael Kohne
If this question can be reworded to fit the rules in the help center, please edit the question.

    
See stackoverflow.com/questions/12687061/… –  MainMa Jan 19 '13 at 13:39
    
Already saw that one, but I wanted to know whether there is any working solution yet to create a real documentation. The "raw" comment-blocks are exactly what I try to avoid :-) –  Max Beikirch Jan 19 '13 at 18:14

1 Answer 1

up vote 1 down vote accepted

If you are looking for something like JavaDoc, you might find JsDoc useful.

I have written a small tool for converting JsDoc comments in TypeScript definition files into JavaDoc-style HTML pages with links between types.

You can find it here, but right now it needs be built from source:

typescript-docs

share|improve this answer

Not the answer you're looking for? Browse other questions tagged or ask your own question.