Suggestion community: elaborate on sparse documentation about nextcloud-vue HOT 4 OPEN

NcVNodes is quite a technical component, more a rendering utility than a UI component, it has no configuration and just does what it says — renders vnodes.

NcActions is the opposite, it is a UI element with a huge number of use cases, configuration, specific usages, and accessibility concerns, requiring detailed documentation.

Missing docs:

• Function, mixins, composables - have no documentation at all. Its existence is barely mentioned
  • It definitely should be documented
  • directives: #5665
  • function: #5669
    • reference and registerReference: todo
  • composables: WIP @ShGKme
  • mixins: WIP @ShGKme
• NcEllipsisedOption, NcVNodes - missing docs
  • NcEllipsisedOption: #5663
  • NcVNodes: #5664
• Server-related components (not UI elements) such as NcRelatedResourcesPanel, NcResource, NcTeamResources, and interactive widgets.
  • These components are hard to document, and at the same time, they are not widely used. I'd propose using https://mswjs.io to document it if we need it
  • NcRelatedResourcesPanel: todo
  • NcResource: todo
  • NcTeamResources: todo

from nextcloud-vue.

@mickenordin Done for NcVNodes, see: #5664

from nextcloud-vue.

It would be helpful if something like your comment about NcVNodes were visible on the documentation page (same thing for NcRelatedResourcesPanel, NcResource, NcTeamResource, etc or other things that is not meant for general consumption). Even if it is just a paragraph that says" "This is not the UI component you are looking for" so that we as consumers of the docs know that this is not something that is useful to us.

from nextcloud-vue.

@mickenordin Done for NcVNodes, see: #5664

Wow! Looks really good! Huge improvement!

Great job!

from nextcloud-vue.