Skip to content

Conversation

@patriciatran
Copy link

Hi CHTC team,

I was working with some students on the renv and conda-env-yaml full workflow from their laptops to CHTC, and took on the task to add onto the existing README instructions based on the feedback and questions from students.

For the recipes/software/R/renv workflow, I added a workflow figure to demonstrate what/how/where files should be located. Students have mentioned that visuals can help. I also added instructions on how to solve the Linux dependencies problem, which were TBD previously (ticket #118430 - thanks @xamberl ). I reformatted the layout and added callout bubbles with extra tips. I added a section linking to the HTC guides/docs for skills mentioned in the readme file.

For the recipes/software/conda/conda-yaml readme file, I mainly reformatted the readme file and added some more details.

In both cases, I added an overview section at the beginning that previews the steps and general concepts. I tried to keep it general not not domain-specific.

I added a folder docs/ to store screenshots/images that are linked in the workflow, but I'm not sure if that follows your stylistic guidelines.

Hope this helps in some way! Suggestions welcomed. And thank you for the example recipes and instructions.

Patricia

@aowen-uwmad aowen-uwmad self-assigned this Dec 3, 2025
@aowen-uwmad aowen-uwmad added the enhancement New feature or request label Dec 3, 2025
- https://conda.anaconda.org/conda-forge
- https://repo.anaconda.com/pkgs/main
- https://repo.anaconda.com/pkgs/r
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- https://repo.anaconda.com/pkgs/r

Apologies for unasked for "drive by" PR comments, but as the Anaconda r channel is deprecated and no longer maintained (c.f. https://www.anaconda.com/blog/changes-to-anacondas-r-channel-support) mentioning it at all should probably be avoided in documentation. As mentioned in Anaconda's blog post, conda-forge has rather good coverage of CRAN these days and so between the conda-forge and bioconda channels this should cover all modern use cases.

Copy link
Author

Choose a reason for hiding this comment

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

That's good to know - I agree we could remove the line mentioning the r channel in the example printout on the documentation to avoid confusion then.

@aowen-uwmad
Copy link
Contributor

Sorry for the delay; I'm planning to review this PR today or tomorrow.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants