Awesome

💡 Introduction

This action automatically scans for express APIs in your codebase and generates a documentation website

Whats New?

• Added JSDOC Like Syntax to define APIs (Thanks to @rahil1304)
• Refactored Code & Reduced Bugs (Thanks to @rosborne132 & @KulkarniSuraj)
• Added Unit Tests

How to add to your workflow ❔

To add this action to your workflow simply modify your workflows main.yml file.

# This is a basic workflow to help you get started with Express AutoDocs Action

name: Express AutoDocs.

# This specifies when the action should occur
on:
  push:
    branches: [master]

jobs:
  generate_docs_job:
    runs-on: ubuntu-latest
    name: Generating Docs
    steps:
      # this step checks out the master branch of your repo using checkout action.
      - name: Checks out the repository
        id: checksout-repository
        uses: actions/checkout@v2
        with:
          repository: ''
      # this step generates the docs
      - name: Generating Docs.
        id: reading-file
        uses: Pika1998/express-autodocs@v0.0.1
      # Use the output from the `hello` step
      - name: Get the output time
        run: echo "The time was ${{ steps.reading-file.outputs.time }}"

⚙️ Configurations

Following are the parameters which you can modify to make this action suitable for your codebase.

Describing your APIs

You can easily add description to your APIs using JSON in comments in the following way

Adding API descriptions

/**
 * @param {string} description - Get a user from database
 * @param {string} [inputs] id - The user id.
 * @param {string} [outputs] user- A user JSON Object.
 */
router.get('/user', auth, (req, res) => {
  User.findById(req.user.id)
    .select('-password')
    .then((user) => {
      res.json(user);
    });
});

🗃️ Example Output

<img src="https://res.cloudinary.com/prafulla98/image/upload/v1599465979/Express%20AutoDocs/express-autodocs-standard1_dtvoj8.png" width='100%'><img src="https://res.cloudinary.com/prafulla98/image/upload/v1599465979/Express%20AutoDocs/express-autodocs-standard2_owbp3q.png" width='100%'>

⏱️ Changelog

Check the CHANGELOG to view the changes done to this action over time

⭐ Contribute

Contributions to this action are most welcomed. please check the Contributions Guide for more details.

🤗 Sponser This Project

<a href="https://www.buymeacoffee.com/prafulla98" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-yellow.png" alt="Buy Me A Coffee" width="45%" ></a>

Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!