6
7 Comments

What's a good code documentation tool?

Is there a tool that automates code documentation for you out there? I would like to get the structure of the mountain of code I have similar to this:

https://docs.woocommerce.com/wc-apidocs/class-WC_Abstract_Order.html

So I don't have to scroll through mountains of code when reviewing certain things.

Preferences: PHP and React.js

Thanks.

posted to Icon for group Developers
Developers
on December 18, 2019
  1. 2

    Postman has a nice feature that allows you to automatically generate API documentation based on your tests. It's such a time-saver.

    https://www.getpostman.com/

    https://www.youtube.com/watch?v=Ayo_KdLLcTA

  2. 1

    Docusaurus is an awesome tool/platform for documentation. It uses react and markdown to write everything: https://docusaurus.io/

    If you’re documenting API’s, I’ve used Swagger open api specification for writing those docs in yaml. Then I use Redoc to display the yaml into a UI.
    Because Redoc is React it can also be embeded in Docusaurus.
    https://swagger.io/specification/
    https://github.com/Redocly/redoc

  3. 1

    What language do you use? Javadoc (for Java) and those inspired by it (for other languages) tend to be pretty powerful syntaxes for inline documentation of code. Many tools exist, depending on the language you are developing in, to take all of the Javadoc or similar comments in your code and generate HTML documentation off of them at build time.

    1. 1

      My usual stack is the traditional LAMP setup. PHP and React.js my go-to focus.

Trending on Indie Hackers
Your SaaS Isn’t Failing — Your Copy Is. User Avatar 61 comments Solo SaaS Founders Don’t Need More Hours....They Need This User Avatar 49 comments Planning to raise User Avatar 22 comments No Install, No Cost, Just Code User Avatar 20 comments The Future of Automation: Why Agents + Frontend Matter More Than Workflow Automation User Avatar 14 comments AI Turned My $0 Idea into $10K/Month in 45 Days – No Code, Just This One Trick User Avatar 13 comments