Elyra documentation¶
The Elyra documentation’s source is stored in the https://github.com/elyra-ai/elyra repository and hosted at https://elyra.readthedocs.io/. The documentation is written in markdown and built using Sphinx.
Contributing to the Elyra documentation¶
To contribute content to the Elyra documentation follow these steps:
Fork the https://github.com/elyra-ai/elyra repository.
Clone your fork.
git clone https://github.com/git-id-or-org/elyra
The documentation assets are located in the
/docs
directory.To add a new document create a new markdown file in the appropriate section subdirectory (e.g.
/docs/source/getting_started
) and add an entry to that section in/docs/source/index.rst
.To update an existing document edit the corresponding markdown file.
Place new or updated images in the
/docs/source/images
directory.PNG
is the recommended format.
Build the documentation assets locally.
In the repository’s root directory (not the
/docs
directory) runmake docs
Review the build output and verify that your updates introduced no warnings or errors.
Review the updated documentation assets.
Navigate to the
/docs/_build/html/
directory.Open
index.html
in a web browser.
Commit your updates to a new branch and open a pull request.