0

I am looking for documentation generation tools that only interpret the comment blocks when generating code documentation. It means that, to some extent, the tool does not depend on the programming language even if I need to declare everything.

One example is YUIDoc that parse "comment blocks, not source code". But the project seems lost support in it github page.

The output could be in any format (HTML, XML, JSON, etc ), but I would prefer a tool that produces an output with more semantically readable structure (e.g. XML, JSON ).

Improve this question
4
  • And what do you use that information for?
    – Thomas Weller
    Jun 19, 2020 at 20:51
  • 1
    Extract some metrics and relational information about the code in software I'm writing. Maybe I could do it with other tools, but I want to do some operations from the information given by the programmer in comments.
    – Erme Schultz
    Jun 19, 2020 at 21:00
  • And I'm not searching for any specific information extraction by now. The only tool I know that met my requirements is YUIDoc. Maybe other tools could provide syntax, tags, and information that I am not expecting.
    – Erme Schultz
    Jun 19, 2020 at 21:11
  • Ok, thanks. I was just considering that you have an XY-issue, where you think analyzing comments would be a solution for a totally diffferent problem. Technically, I think such a tool should be possible, especially if you're willing to configure much. Yet, I don't know any out-of-the-box tool.
    – Thomas Weller
    Jun 22, 2020 at 6:39

0

Reset to default

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Browse other questions tagged or ask your own question.