DOC: Add documentation on CONDA_OVERRIDE_ARCHSPEC

[matthewfeickert]

Resolves #13

(Does this by addressesing the request in #13 (comment))

• Add instructions for overriding the __archspec virtual package with the CONDA_OVERRIDE_ARCHSPEC environment variable.
  • c.f. Specifying _x86_64-microarch-level=something doesn't solve properly. #13 (comment)
• Note that the _{{ family }}-microarch-level packages are not intended for users to ever interact with directly.
  • c.f. Specifying _x86_64-microarch-level=something doesn't solve properly. #13 (comment)
  • An aside here: This is not being clearly communicated by the underscore as it both shows up in the user facing README on the feedstock and is something that shows up when constructing recipes for feedstocks.

Checklist

• Used a personal fork of the feedstock to propose changes
• Bumped the build number (if the version is unchanged)
  • This is documentation only, so there is no need to publish a new build to Anaconda's servers.
• [N/A] Reset the build number to 0 (if the version changed)
• Re-rendered with the latest conda-smithy (Use the phrase @conda-forge-admin, please rerender in a comment in this PR for automated rerendering)
• Ensured the license file is being packaged.

[matthewfeickert]

@conda-forge-admin, please rerender

[conda-forge-admin]

Hi! This is the friendly automated conda-forge-linting service.

I wanted to let you know that I linted all conda-recipes in your PR (recipe/meta.yaml) and found some lint.

Here's what I've got...

For recipe/meta.yaml:

• ❌ The recipe must have some tests.

_{This message was generated by GitHub Actions workflow run https://github.com/conda-forge/conda-forge-webservices/actions/runs/12402018273. Examine the logs at this URL for more detail.}

[matthewfeickert]

@ikrommyd @jjerphan as you were also involved with this discussion I'd like to request reviews from you as well as @isuruf.

It is probably easiest to just read the rerendered text on my fork's PR branch: https://github.com/matthewfeickert/microarch-level-feedstock/tree/doc/add-instructions-on-override-of-level?tab=readme-ov-file#about-x86_64-microarch-level

---

I will open up a PR to https://github.com/conda-forge/conda-forge.github.io that addresses conda-forge/conda-forge.github.io#2105 once this PR has been reviewed and merged. I'll also read over conda-forge/conda-forge.github.io#1261.

[matthewfeickert]

Given that I mentioned conda-forge/conda-forge.github.io#2105, cc @traversaro for feedback here too.

[traversaro]

Thanks! I think the documentation in this PR make sense.

[ikrommyd]

I'm happy with the README updates. I don't know if it deserves a mention here: https://docs.conda.io/projects/conda/en/stable/user-guide/tasks/manage-virtual.html as well

[traversaro]

I do not think we need to modify the docs, but I think it there is a related CEP PR that may be of interest to anyone contributing to this discussion: conda/ceps#103 .

[matthewfeickert]

I don't know if it deserves a mention here: https://docs.conda.io/projects/conda/en/stable/user-guide/tasks/manage-virtual.html as well

@ikrommyd I already link that here.