-
Notifications
You must be signed in to change notification settings - Fork 3
Closed
Labels
contentContent related issueContent related issue
Description
Before our 2023 hackathon, I think the contributor's guide needs some updating. Here is a potential outline:
- Data access (include a statement encouraging the use of freely-available data, with the option for some small files to be added to the cookbook)
- Use the template (maybe just a few edits for clarity)
- Develop your cookbook (How much detail should we include here? We may be able to just link our GitHub/Conda tutorials and otherwise assume the reader knows how to do this part.)
- Pre-transfer checklist
- Update README.md, including badge links
- Make changes to _config.yml. These will show up on the card in the gallery.
- title
- author
- description
- thumbnail
- tags
- Add notebooks to _toc.yml (Table of contents)
- Clear all notebook outputs
- Cookbook successfully builds using either GitHub Actions or the Pythia Binder
- Transfer to the ProjectPythia org (I think this part is mostly fine the way it is now.)
- Add cookbook to gallery
Questions:
- How complete should a cookbook be before it gets transferred to this org? I think there should be at least one notebook that builds successfully using our infrastructure.
- Do we want to make the Pangeo Discourse the main way contributors let us know about their cookbooks? How about a Google Form?
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
contentContent related issueContent related issue
Type
Projects
Status
Done