What value is gained by differentiating between functions and instructions?
Sounds good to me. Although then we'll need to differentiate between instructions and functions in the stages.
fwiw we may need to introduce a docs/util
folder sometime in the future as well, as I believe especially the graph drawing utils in docs/design/util/graphics.typ
to be useful in proposals as well
I really dislike using the word execution
here, as it's a very common trigger word. Do you have any alternative ideas?
How would one write type signatures with multiple generic arguments?
Also I suggest adding a title and subtitle once katzen-cafe/iowo#2 is merged.
This is ready to look at, content-wise. I'll furthermore
- rewrite
justfile
to use nushell instead - add instructions in
CONTRIBUTING.md
to check out PRs
Operators, to me at least, have the implication of being one or two characters long and usually special chars. How about "instruction" instead?
About the tooling stuff: I suggest adding Penpot, since I generally prefer penpot for design work. I don't use it for icons etc, that's indeed where I fall back to inkscape, but generally I…
Tbh I don't think it really matters atm if we do discussions over forgejo or over Matrix. Matrix is a bit more comfy though
Personally I'd suggest
- for documents and longer-form stuff → typst
- for meta-stuff → markdown
- for the code itself → Rust
- for build stuff → just (and a nix flake sometime…
oh no i forgor to write the CONTRIBUTING.md specifying we need one approving review to merge stuff, whatever, i'll do it later