Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cookbook guide is inconsistent with latest template #433

Closed
brian-rose opened this issue Jun 4, 2024 · 5 comments · Fixed by #435
Closed

Cookbook guide is inconsistent with latest template #433

brian-rose opened this issue Jun 4, 2024 · 5 comments · Fixed by #435
Assignees
Labels
content Content related issue

Comments

@brian-rose
Copy link
Member

The section Update repository-specific text currently says that "tags" and "thumbnail" should be edited in _config.yml but these fields are actually in _gallery_info.yml.

@brian-rose brian-rose added the content Content related issue label Jun 4, 2024
@brian-rose
Copy link
Member Author

Also I think this line is not needed and should be removed:

Edit the notebooks/how-to-cite.md file with your Cookbook title in the line, “The material in is licensed …”

because the boilerplate text is just "The material in this Project Pythia Cookbook is licensed ..." and that's good enough for most.

@brian-rose
Copy link
Member Author

In general I think that some of the steps in the Cookbook guide can be reordered. I don't think it makes sense to ask people to fill out the CITATION.cff file until after content development. The guide should focus on getting people building content as painlessly and possible, and then follow up with additional steps for getting the Cookbook reviewed and listed on the Gallery.

@brian-rose
Copy link
Member Author

One more point: when the repo is transferred to ProjectPythia org, there are quite a few URLs that need updating across multiple files. In many ways it would be simpler to encourage people to reverse the order: transfer the repo immediately, before running the trigger-replace-links action.

We should encourage people to see parking the repo in the ProjectPythia org just a simple way to express intentions to eventually have the work appear in the Pythia gallery, as well as inviting collaboration.

Review and acceptance into the gallery is an entirely separate step.

@brian-rose
Copy link
Member Author

I will attempt a PR that reorders the instructions and resolves the inconsistencies noted above.

@brian-rose brian-rose self-assigned this Jun 4, 2024
@brian-rose
Copy link
Member Author

Our current guide also says nothing about the testing and publishing infrastructure, and how to interact with Pull Requests, previews, etc. I'm adding detail about this to the revised guide.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content Content related issue
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant