Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add some info about how to transition from Anaconda's default channel #2107

Merged
merged 14 commits into from
Sep 17, 2024

Conversation

hmaarrfk
Copy link
Contributor

@hmaarrfk hmaarrfk commented Mar 10, 2024

A common theme I see when helping users on github is that they have mixed packages from Anaconda + conda-forge. This really isn't the user's fault since I still remember the days that we had this as the recommended workflow.

However, today this workflow leads to totally broken environments.

I would like to document a guide that I can point them to and politely say:

Unfortunately this is no longer supported, see .... for how you can
migrate.

PR Checklist:

  • note any issues closed by this PR with closing keywords
  • if you are adding a new page under docs/, you have added it to the sidebar in docs/sidebar.json
  • put any other relevant information below
  • Add a historical reference: drop defaults announce #1513

Copy link

netlify bot commented Mar 10, 2024

Deploy Preview for conda-forge-previews ready!

Name Link
🔨 Latest commit 59e0751
🔍 Latest deploy log https://app.netlify.com/sites/conda-forge-previews/deploys/66e81ceb9eee0b000829f8cf
😎 Deploy Preview https://deploy-preview-2107--conda-forge-previews.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

conda clean --all
```

2. Create a zip archive of your conda installation. Use your favorite graphical tool
Copy link
Member

Choose a reason for hiding this comment

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

They can also use ls ~/.conda/environments.txt (and/or conda info --envs) to show their environments, so they can mv them somewhere safe and then put them back in place. Or we could list how to generate platform-specific lockfiles with conda list --explicit --md5 that they can then use to regenerate those envs.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

i'm mostly trying to keep it as simple as possible.

Many of these users are true users of conda, and not reallly developers of it, so these "tricks" make it seem more scary than anything.

Trying to "keep an environment alive" like this, and changing the the default environment, is likely going to be a huge problem when they type conda install ... any other package.

Copy link
Member

Choose a reason for hiding this comment

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

I wonder if it is worth mentioning conda env export --from-history. It is probably a simple way to get a close-ish env file for existing environments without much magic or advanced directory/file browsing/moving.

Copy link
Member

Choose a reason for hiding this comment

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

Added a little paragraph for both things without sacrificing the simplicity of the zip archive. Let me know what you think.

Copy link
Member

Choose a reason for hiding this comment

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

Perfect!

@jaimergp
Copy link
Member

Nice! Let me know when you want a more thorough review. I just added a few comments that might be useful at this early stage.

@hmaarrfk
Copy link
Contributor Author

hmaarrfk commented Aug 4, 2024

I'm a little confused with what changed over the months on the CIs and the pre-commit hook. how do i run prettier locally? How can I see the preview of the website?

@jakirkham
Copy link
Member

pre-commit.ci autofix

@jaimergp
Copy link
Member

jaimergp commented Aug 9, 2024

How can I see the preview of the website?

The Deploy Preview of netlify there in the CI summary. But it's failing now. Let me take a look.

@jaimergp
Copy link
Member

jaimergp commented Aug 9, 2024

@hmaarrfk hmaarrfk marked this pull request as draft August 9, 2024 10:49
@hmaarrfk
Copy link
Contributor Author

hmaarrfk commented Aug 9, 2024

Awesome. Some of the text really needs work but at least the infrastructure is there

hmaarrfk and others added 8 commits September 10, 2024 16:33
A common theme I see when helping users on github is that they have
mixed packages from Anaconda + conda-forge. This really isn't the user's
fault since I still remember the days that we had this as the
recommended workflow.

However, today this workflow leads to totally broken environments.

I would like to document a guide that I can point them to and politely
say:

> Unfortunately this is no longer supported, see .... for how you can
migrate.
@hmaarrfk hmaarrfk marked this pull request as ready for review September 10, 2024 20:33
@hmaarrfk
Copy link
Contributor Author

@jaimergp feel free to edit and push. I think if you "push" to the branch i'll be persuated to take your opinion. Keeping things simple is hard to balance.

@jaimergp
Copy link
Member

Thanks @hmaarrfk. I added a few things and edited a couple of terms for clarity. Take look and adjust whatever you think it's necessary. This is looking fine to merge, imo.

@hmaarrfk
Copy link
Contributor Author

Thanks all!!!

@beckermr beckermr merged commit ba9c6b4 into conda-forge:main Sep 17, 2024
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Development

Successfully merging this pull request may close these issues.

5 participants