Conda-forge.github.io: Document how to use `mambabuild`

[leofang]

https://gitter.im/conda-forge/conda-forge.github.io?at=602417279fa6765ef80e6bf4

I think we need to add

1. How to enable it in CI: IIUC we need build_with_mambabuild: True in conda-forge.yaml
2. How to use it locally for debugging: conda mambabuild ...

cc: @wolfv

[wolfv]

hi @leofang, thanks for opening this issue! Yes, it would be great to have some docs around this. Are you willing to write something up?

For conda-forge:

• add build_with_mambabuild: True to conda-forge.yaml, then _rerender_ with conda-smithy (locally: conda install conda-smithy -c conda-forge && conda smithy rerender. also important to note: the builds made with mambabuild won't (and probably shouldn't) be uploaded to conda-forge, this is purely for debugging (for now)
• locally, first: {conda,mamba} install boa -c conda-forge, then you can use conda mambabuild myrecipe

[leofang]

Thanks, @wolfv. I posted this mainly to prevent it from being forgotten. If someone is interested in writing it up, that couldn't be better. Otherwise, I could pick it up at some point (definitely not this week) 🙂

[Aaishpra]

@wolfv @leofang if you allow I would like to give this issue a try as an outreachy internship applicant.
Since this is my first time with conda-forge I would appreciate it if you can guide me on how to approach this issue. 🙌🏻

[jakirkham]

@viniciusdc, is the contact point for Outreachy. Cc-ing him here

[leofang]

@ForgottenProgramme asked me about mambabuild offline, I think she's also interested in contributing. I'll let you coordinate..

[Aaishpra]

Sure👍🏻 I am good with anything.

[viniciusdc]

Great, we will need to handle that a little. @ForgottenProgramme also reach me out and @wolfv to help contributing here. Is it possible for you guys @leofang @jakirkham add some more details to the current opened issues? It would definitely help the new applicants

[jakirkham]

I think people are interested in trying to use mambabuild. However there's not really documentation covering this currently. Unfortunately that's about all the context I have here as this is not an issue I've been following too closely

[viniciusdc]

@ForgottenProgramme @Aaishpra any news on this ?

[ForgottenProgramme]

Yes, @viniciusdc.
I've been reading about mamba-build.
I realized the conda-forge docs do not have any dedicated section for mamba. I think we need one.
Therein we document about all it's use cases for conda-forge. ( For example: config mamba with conda-forge, how to enable it in CI and so on)

I'll take this up.

[ForgottenProgramme]

Also, @leofang had suggested the 'Knowledge Base' page in the maintainer docs might be a good place for adding 'mamba' section.

https://conda-forge.org/docs/maintainer/knowledge_base.html

[viniciusdc]

Also, @leofang had suggested the 'Knowledge Base' page in the maintainer docs might be a good place for adding 'mamba' section.

https://conda-forge.org/docs/maintainer/knowledge_base.html

I agree

[ForgottenProgramme]

For future reference (whenever work on mamba docs begins full fledged):

@wolfv 's blog that answers 'what to do if conda is too slow/ why mamba?' : https://wolfv.medium.com/making-conda-fast-again-4da4debfb3b7

Information about the mamba organization and how mamba actually works under the hood : https://medium.com/@QuantStack/open-software-packaging-for-science-61cecee7fc23

(We might not need to include this information in conda-forge docs(atleast not in detail). It's correct place would be mamba-org's own docs. It might still be helpful to read this before beginning documentation around mamba. )

[ForgottenProgramme]

Link to the Gitter chat on this issue. Could be useful later.

https://gitter.im/conda-forge/conda-forge.github.io?at=60742f23ae90f3684077029e

[leofang]

Closed by #1353. Related: #1381.