Skip to content

Update bioconda utils docs, update deps, clean up docs - #53

Open
paperbenni wants to merge 29 commits into
bioconda:mainfrom
paperbenni:update-bioconda-utils-docs
Open

Update bioconda utils docs, update deps, clean up docs#53
paperbenni wants to merge 29 commits into
bioconda:mainfrom
paperbenni:update-bioconda-utils-docs

Conversation

@paperbenni

@paperbenni paperbenni commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Docs updates

bioconda-utils docs were scattered throughout the docs pages, and some commands were undocumented entirely. This adds a central bioconda-utils docs page and makes other pages link to it.

Pipeline updates

The docs build pipeline referenced a legacy bioconda-utils dependencies txt file to install dependencies. This switches the build pipeline over to pixi, which also brings it in line with how bioconda-utils is built.
It also documents the CLI changes in bioconda/bioconda-utils#1125

SSG updates

I switched the theme to PyData from alabaster. This gives us responsive design, a table of contents, dark mode, clipboard buttons, easy ways of linking to pages, a modern layout basically for free.
The live server also flagged a few warnings which I fixed

Cleanup

Some links were invalid, some pages were suggesting usage of mamba cli or micromamba.
This was not a thorough pass, some pages still mention Python 3.6, just things I noticed while primarily writing the bioconda-utils docs

Screenshots

Old

image

New

image

@paperbenni paperbenni changed the title Update bioconda utils docs Update bioconda utils docs, update deps Jul 4, 2026
@paperbenni paperbenni changed the title Update bioconda utils docs, update deps Update bioconda utils docs, update deps, clean up docs Jul 4, 2026
@paperbenni
paperbenni marked this pull request as ready for review July 4, 2026 11:16
@bgruening

Copy link
Copy Markdown
Member

@jmarshall does this look good to you?

@aliciaaevans aliciaaevans left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a couple of things.

Thanks for adding the documentation for bioconda-utils.

Comment thread source/conf.py Outdated
Comment thread source/contributor/guidelines.rst Outdated
Comment thread source/contributor/updating.rst
paperbenni and others added 3 commits July 7, 2026 11:06
Co-authored-by: Alicia A. Evans <108547992+aliciaaevans@users.noreply.github.com>
@paperbenni

Copy link
Copy Markdown
Contributor Author

this should be good to go now @aliciaaevans

@bgruening
bgruening requested a review from aliciaaevans July 15, 2026 02:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants