Open raymcdermott opened 7 years ago
Thanks for all this Ray - just want to let you know I see this and the other issue and would like to make these things better, but will likely not have time to look at these properly till post-Conj.
Great! There's no hurry :)
In the spirit of reducing your workload, can I do anything to move it forward independently?
PS. I have signed the RHCA
I would love to have a more comprehensive overview of where things like varargs / multiarity / prepost / etc are available across the different kinds of invocable things (functions, macros, protocols, multimethods, ??). All of this is good content - what would help is having a PR I can review.
I think most of this stuff would be more applicable on a Protocols guide (not the reference page, although a brief statement there might also be ok), but we don't have such a thing right now.
When implementing Protocols using
defrecord
there are some missing affordances.As an example, :pre and :post conditions cannot be applied.
[ Yes, I know we will soon have spec but these affordances will not be deprecated AFAIK. ]
Affordances not available on
defrecord
ordeftype
Affordances are available via
extend-protocol
I don't want to claim this is a bug. But it's a sign that these options have pros and cons which are not currently well explained.
I would like to develop a more comprehensive table of features / affordances might be nicer than the current bullet list