You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The HOW types, look for instance at EnumHow, do a lot of roles and not all of them are documented, as can already be seen from them not appearing in the table of contents of the HOW type.
Metamodel::Documenting
Metamodel::Stashing
Metamodel::Mixins
Metamodel::MultiMethodContainer
what else?
Suggestions
Complete the list above and then document them. I suppose that the line between "documentable" and "utter implementation detail" is especially thin here, so that might have to be decided on a per-case basis. I would argue that Documenting and MultiMethodContainer are documentable.
JJ
added
docs
Documentation issue (primary issue type)
new
part of "docs" - indicates that this documentation is for a new, currently undoc'd section
labels
May 29, 2019
The problem
The HOW types, look for instance at EnumHow, do a lot of roles and not all of them are documented, as can already be seen from them not appearing in the table of contents of the HOW type.
Suggestions
Complete the list above and then document them. I suppose that the line between "documentable" and "utter implementation detail" is especially thin here, so that might have to be decided on a per-case basis. I would argue that
DocumentingandMultiMethodContainerare documentable.References
Seems to be a continuation of #1306
The text was updated successfully, but these errors were encountered: