Repository (Management) Discussions

[nobkd]

I'd collect general things about the repository and repository management here, that (I feel) are worth a discussion.

I think it would be okay to use each "main answer" under this discussion as a new starting point for topics, so the talk doesn't spread out over different issues, PRs, other discussions.
(This can also be a negative point, if there are too many topics, but I think it will be okay for now)

Feel free to open your own related topic here

[nobkd]

JS Docstrings

See #201

(Could be relevant for the future development.)

Yes / No / Maybe in the future, but not now

[tipiirai]

I vote no. I suggest we put this effort to improving test suites. Time better spent I think.

[nobkd]

Lock-file handling

Lock files

Pro

• Reproducible tests (if used with frozen-lock file on installations)
  Revert unnecessary changes of bun.lockb in PR #149 #150 (comment)
  Fix Windows CI with jest as alternative to bun, also add more matrix envs #154 (comment)
• Faster installs (at least for bun)
  Revert unnecessary changes of bun.lockb in PR #149 #150 (comment)
  • does not have to rebuild the dependency tree all the time

Contra / Needs decision

• binary lock file is unreadable unless using an extension / updating the git config
  Remove esbuild from devDeps but keep testing in CI, fix #139 #149 (comment)
• problem of "least surprise" (scary changed binary lock file / git conflicts)
  Remove esbuild from devDeps but keep testing in CI, fix #139 #149 (comment)
  Revert unnecessary changes of bun.lockb in PR #149 #150 (comment)
• no / one / multiple lock files
  Fix Windows CI with jest as alternative to bun, also add more matrix envs #154 (comment)
• might need frequent updates
  Remove esbuild from devDeps but keep testing in CI, fix #139 #149 (comment)

[nobkd]

Update: bun now has a text based lock file as default. We could migrate to it.

[tipiirai]

I'm a rookie when it comes to lock files, so not much opinions here. But I definitely favor Bun first approach. With CSS support, I might even vote for dropping Node support completely.