help icon indicating copy to clipboard operation
help copied to clipboard

Best practices / standards: Workgroup + sprints?

Open tony opened this issue 2 years ago • 0 comments

There are areas that could be covered are infra / devops / even bikesheddy when taken alone - but at scale, very concrete; best practices:

  • test framework:
    • pytest vs unittest, either?
    • require tests to merge?
    • doctests?
  • CI
  • github templates:
    • bug report template? issue template?
  • Whether or not to add .python-version (pyenv), .tool-versions (asdf)
  • documentation:
    • furo by @pradyunsg
      • jazzband projects could perhaps have a furo theme w/ jazzband colors?
    • general structure
      • e.g. PyPA's doc structure with pip and furo are laid out very nicely
    • language support? e.g. /en/
    • version support? e.g. /v1.2.0/
  • changelog template?
  • README template structure
  • Things that are PR'able via @jazzband-bot, vs things that may need a sprint across projects to do by hand
  • Anything else?

Are any of these worth taking up in an independent issue here? Somewhere else? Worth discussing in whole?

Is it worth having an "exemplar" or "flagship" jazzband python project with the latest best practices that others can imitate?

tony avatar Oct 18 '22 23:10 tony