Issues with binder env about xgcm-examples HOT 6 CLOSED

Thanks @rabernat
I think I just pasted this on the wrong line. Apologies...

Admittedly I am flying a bit blind here. I think it might be good to show an example of 'what to replace' in the Remove the dummy content and add your content. bullet?

I used some of the existing gallery repos to 'visually diff' the changes necessary, but clearly, I got confused in the process.

from xgcm-examples.

Agree it is currently super confusing. Would love suggestions on how to improve.

from xgcm-examples.

I just now saw this section.
Id suggest a few things:

1. Link to that bottom section in the bullet mentioned above.
2. Somehow mark and indicate which entries need to be changed. I personally like a concrete example (e.g. one of the existing gallery repos). Perhaps you could show the 'diff' output of the template and another repos yaml?

from xgcm-examples.

3. This sentence ("Sometimes, the GitHub Action to add your repo as a submodule will fail. We can work with you to identify and fix issues. Sometimes, making a new issue in the same way as above is necessary to correctly reload new settings from your gallery repo.") is great advice, but I think it would be good to show the user what a 'success' looks like beforehand.

E.g. Before the sentence say: "If your request was successful, you will see an automated response like this:"

from xgcm-examples.

4. I think the user then needs some more info about what will happen next and if they need to do anything except for wait for the gallery maintainers to merge?

from xgcm-examples.

@rabernat Should I paste these suggestions in another issue, so we can close this one?

from xgcm-examples.