Skip to content

This repository provides a way to automate the creation of documentation for an application.

Notifications You must be signed in to change notification settings

paley777/rtd-github-pages

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Continuous Documentation Repository 💻

This repository provides a way to automate the creation of documentation for an application.

📱 Results in this Link!

🚀 Getting started

The process of automating this documentation creation is: 1.Autodoc calls the .py file automatically to generate documentation. 2. Generate documentation (sphinx-docs) automatically when a commit is pushed to the repository. 3. After being generated automatically, the results of the html documentation build are moved to a new branch called "gh-pages". 4. We have set the branch as a Github Pages so that it can be used to host the documentation. 5. All the processes above occur repeatedly when there are changes via push commit automatically. Without the need to change rst files.

Files used:

  1. docs_pages_workflow.yml as a file executed by GitHub Actions.
  2. buildDocs.sh as a script to build documentation and push it to the "gh-pages" branch.

💻 Technologies

  • Sphinx Docs
  • Read the Docs
  • GitHub Actions
  • GitHub Pages

About

This repository provides a way to automate the creation of documentation for an application.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages