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
Two Votes on Product Hunt → 2,000+ Users in Three Weeks Anyway 😌 User Avatar 56 comments Fixing my sleep using public humiliation and giving away a Kindle User Avatar 23 comments The best design directories to show off your work User Avatar 13 comments Retention > Hype: What Are We Really Chasing as Builders? User Avatar 10 comments A growth tool built for indie developers: Get influencer marketing done in 10 minutes and track the results. User Avatar 8 comments Business is not a skill game. It’s a connection game disguised as meritocracy. User Avatar 7 comments