Skip to content

A GitHub Action that keeps your repository’s README.md fresh and clean! Automatically generates or updates your README with technical documentation and usage examples, ensuring your project stays well-documented with zero hassle.

License

Notifications You must be signed in to change notification settings

Coderrob/update-readme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Update README.md with Action Metadata

Updates a README.md file with metadata from an action's YAML configuration file. This includes information such as the action name, description, inputs, outputs, and other relevant details.

Branding

Attribute Value
Color green
Icon book

Inputs

Name Description Default Required
action-file-path The path to the YAML configuration file for the action. This is relative to the repository root. If not specified, it defaults to 'action.yml'. ./action.yml ✅ Yes
action-repository The repository where the action is located. This is used to generate links and references within the README.md file. ${{ github.action_repository }} ❌ No
readme-file-path The path to the README.md file that should be updated. This is relative to the repository root. If not specified, it defaults to 'README.md'. ./README.md ✅ Yes

Outputs

This action does not define any outputs.

Runs

Execution Type: node20

Example Usage

jobs:
  example:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Source
        id: checkout-source
        uses: actions/checkout@v2

      - name: Update README.md with Action Metadata
        uses: Coderrob/update-action-readme@v1
        with:
          action-file-path: <value>
          action-repository: <value>
          readme-file-path: <value>

Acknowledgments

This project leverages Markdown generation techniques from coderrob.com, developed by Robert Lindley.

About

A GitHub Action that keeps your repository’s README.md fresh and clean! Automatically generates or updates your README with technical documentation and usage examples, ensuring your project stays well-documented with zero hassle.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published