Reconcile environment for development and docs building

[HangenYuu]

Description

Updated the environment.yml for developing and docs building locally.

Related Issue

• Closes Reconcile environment for development and docs building #716, Closes DOC: Installation instructions in the developer start guide outdated #696
• Related to Update example in "Adding JAX and Numba support for Ops" #687

Checklist

• Checked that the pre-commit linting/style checks pass
• Included tests that prove the fix is effective or that the new feature works
• Added necessary documentation (docstrings and/or example notebooks)
• If you are a pro: each commit corresponds to a relevant logical change

Type of change

• New feature / enhancement
• Bug fix
• Documentation
• Maintenance
• Other (please specify):

[HangenYuu]

Maybe not merge yet. Let me update the documentation first. I opened the PR first though.

[ricardoV94]

Maybe not merge yet. Let me update the documentation first. I opened the PR first though.

You can click Convert to a draft button when a PR is not ready (I did that now). That way there's no risk of premature merging. Anytime it's ready you click Ready for review

[HangenYuu]

Okay I have also updated the documentation. The change should be good for merging.

[OriolAbril]

Is anyone using the docgen.py script for something other than to generate the html build of the docs? I was just going over it and it basically calls sphinx with different defaults (such as default to building both html and pdf via latex instead of only building html).

If it isn't really being used (doc building and PR previews via readthedocs do not use it for example), it is probably best to remove and update the contributing guide a bit more to use the sphinx command directly instead of running docgen script

[OriolAbril]

It can be installed from conda forge too, no need to include pip and install from github

[HangenYuu]

When I search on conda libraries website I did not find the theme. In the GitHub workflow I also see that it is published on PyPI only, so I follows that environment.yml in the doc folder 😅. Can you give me the conda package website like this one: https://anaconda.org/conda-forge/pydata-sphinx-theme?

[OriolAbril]

The one in the doc folder should also be updated then. Link: https://anaconda.org/conda-forge/pymc-sphinx-theme

[HangenYuu]

Is anyone using the docgen.py script for something other than to generate the html build of the docs? I was just going over it and it basically calls sphinx with different defaults (such as default to building both html and pdf via latex instead of only building html).

If it isn't really being used (doc building and PR previews via readthedocs do not use it for example), it is probably best to remove and update the contributing guide a bit more to use the sphinx command directly instead of running docgen script

Agreed. Let me deal with this.

[HangenYuu]

@OriolAbril

• Updated the dependency to install from conda-forge instead of pip.
• Removed the script & updated the developer guide.

[ricardoV94]

Thanks a ton @HangenYuu