documenting local runs better

[ngam]

PR Checklist:

• make all edits to the docs in the src directory, not in docs or in the html files
• note any issues closed by this PR with closing keywords
• put any other relevant information below

[ngam]

ready for review, in #1587's stead, cc @isuruf and @jakirkham

[isuruf]

This seems like an awful lot of instructions to read for a beginner. Can we port build-locally.py from a feedstock here?

[ngam]

build-locally.py

You mean code-wise? Yes! That'd be super neat if we have the same process in staged-recipes as the feedstocks. It makes a huge difference! It took me a long time to figure things out (granted, I am not good at reading documentation)

[isuruf]

Yes, we'll have to copy build-locally.py from a feedstock and make a few changes.

[ngam]

Yes, we'll have to copy build-locally.py from a feedstock and make a few changes.

Above my pay grade for now (also trying to get mxnet on cf), but I can think about it later. I fully support this tho

[beckermr]

See above. I have not looked at the rest.

[ngam]

Do NOT merge. This PR will be moot if this conda-forge/staged-recipes#17617 goes through.

[ngam]

Thanks to @isuruf's PR conda-forge/staged-recipes#17617, this is now much much simpler!

[ngam]

@isuruf @beckermr now that conda-forge/staged-recipes#17617 is merged, this should be reviewed and merged. Thanks!

[beckermr]

Does this build all recipes? It might be good to specify how to build just one of them if that is possible.

[ngam]

I believe it builds only one. So, python build-locally.py will simply prompt you to choose from a list and python build-locally.py linux64 will bypass that prompt and build the linux64 configuration.

[beckermr]

I meant the recipes not the platforms. I've asked a question on the stages recipes pr. We are good to merge this for now and we can clarify it later. Thank you!