This is a migrated thread and some comments may be shown as answers.

Docs not finished? Where are attributes of components listed?

1 Answer 47 Views
General Discussions
This is a migrated thread and some comments may be shown as answers.
BitShift
Top achievements
Rank 1
Veteran
BitShift asked on 24 Oct 2019, 03:59 PM

For example, the menu component.  Where are all the available attributes and events listed for this component. Yes, I see in the examples a "Data" and "orientation" attribute are used, but seems this should be explained in an "api" section for each component?

I see the API Reference link but this seems like just a dump of the entire library, rather than a component-by-component reference?

However, same goes for the other components as well.

1 Answer, 1 is accepted

Sort by
0
Marin Bratanov
Telerik team
answered on 25 Oct 2019, 08:02 AM

Hello,

This is the general way conceptual documentation (that is, those articles you see under /components, for example) and API reference are separated. Cloning the API reference causes outdated information and incomplete lists in the long run, in addition to a maintenance burden that takes time away from other, more beneficial tasks (such as creating more examples).

The two must not be copies of each other, the full API reference that is taken from the codebase itself is the place to see all the available parameters and events. You can also see them in the VS Intellisense.

The conceptual documentation articles are about as complete as they would be. I will not add full copies of the API reference to them, and I am considering what to do with the existing ones, especially around the grid columns, and I may remove them in favor of a few examples and links to the actual API reference.

By the way, the filter field on the top left corner lets you easily find the components you seek, just start typing their name there (e.g., "TelerikGrid" or "TelerikTabStrip") and you will see the relevant articles only.

Regards,
Marin Bratanov
Progress Telerik

 UI for Blazor
Tags
General Discussions
Asked by
BitShift
Top achievements
Rank 1
Veteran
Answers by
Marin Bratanov
Telerik team
Share this question
or