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

Add a repo checklist to README.DEV #630

Closed
clizbe opened this issue May 8, 2024 · 6 comments · Fixed by #910
Closed

Add a repo checklist to README.DEV #630

clizbe opened this issue May 8, 2024 · 6 comments · Fixed by #910
Labels
Type: addition Add something that doesn't exist Zone: documentation Improvements or additions to documentation

Comments

@clizbe
Copy link
Member

clizbe commented May 8, 2024

Description

We should have a checklist people can follow to make sure future repos are up to our standards.
Feel free to add to the list below:

All Repos

  • Use BestieTemplate
    • Citation CFF included?
    • Add PR & Issue Templates
    • Formatter & Linter (defaults are for Julia)
  • Zenodo DOI
  • Protect the main branch
  • Register package

Tulipa Repos

  • Docs that point to TulipaEnergyModel (if a Tulipa repo)
    • Common stuff lives on TEM, package-specific lives in package
  • Match the labels (Types, Zones) so we can label Issues on the Project board

Related Issues

No response

@clizbe clizbe added Zone: documentation Improvements or additions to documentation Type: addition Add something that doesn't exist labels May 8, 2024
@datejada
Copy link
Member

@clizbe, do we still need this issue? I think we have it covered using BestieTemplate since it is now applied to all the TulipaX repositories.

@clizbe
Copy link
Member Author

clizbe commented Oct 27, 2024

Yeah BestieTemplate covers most of it, but maybe we still need a Developer docs section about creating a new package in the project? I don't think Bestie protects the main branch, for instance. We don't need to repeat all the stuff like what's required to register a Julia package, but maybe a procedure to follow that includes "Start with BestieTemplate" and a few other things.

@datejada
Copy link
Member

@clizbe, thanks! would you like to tackle this issue? 😃

@clizbe
Copy link
Member Author

clizbe commented Oct 28, 2024

😅 Of course!

@clizbe
Copy link
Member Author

clizbe commented Oct 28, 2024

Looks like Bestie saves the day again with the Setting Up Your Package section!
https://juliabesties.github.io/BestieTemplate.jl/stable/10-full-guide/#Setting-up-your-package

I think that covers most of it. Maybe just protecting Main branch since that's how our specific workflow goes, but maybe we don't have to document that?

@abelsiqueira
Copy link
Member

PRs adding branch protection to Besties docs are welcome

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Type: addition Add something that doesn't exist Zone: documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants