To build the documentation:, from the /docs
folder:
Run:
python autogeneration/pages/evaluators.py
-> creates evaluator pagespython autogeneration/pages/metrics.py
-> creates metrics page
Note: credoai-lens and credoai-connect needs to be installed for this to work correctly.
After pushing to github, Read the Docs will build the documentation if the branch is currently activated.
For local build, on top of the previous commands, run make html
directory and the docs site will build to: docs/_build/html/index.html
, which can be opened in the browser.
Make sure you have Sphinx installed if you are building the docs site locally.
Building the docs requires additional dependencies listed in
docs/requirements.txt
.
This directory contains the content relevant to documentation & website
generation using sphinx
. The most important resource is conf.py
which
includes settings and extensions that sphinx
uses.
These docs make use of Sphinx's autosummary recursion. To see how to configure Sphinx to do this, see this Github repo README.
python setup.py sdist bdist_wheel
After creating the required files in dist
and installing twine, run:
python -m twine upload --repository testpypi dist/*
For more info, follow instructions here to upload to PyPi.
To install from the test PyPi server (useful before full deployment) run:
pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple credoai-lens
python -m twine upload dist/*