Help

This Product Ideas board is currently undergoing updates, but please continue to submit your ideas.

Users Description for Base, Table and Column to enhance the API Doc

cancel
Showing results forย 
Search instead forย 
Did you mean:ย 
Michael_Gehrman
5 - Automation Enthusiast
5 - Automation Enthusiast

The API Documentation is a great way, to communicate with developers!

It would be great to add a little more context to the data, to help developers handling it correctly.

The Base already has a description. This could be appended to the โ€œIntroductionโ€ section of the API Documentation.

a3791644cb7bc2659b094a666c6cafdc3bd3d582.png

Descriptions for Tables and Columns

Description-Fields could be added to Tables and Columns as well. Helping to communicate the proper content of ambiguous fields.

Use Case:

Storing the production Data of print products in a base. In a print context the width of a page can be described with or without the page bleed. Additionally the description would help to communicate the unit used for the number field. A description for this field given by the author could be: ยปWidth of the page in millimeter, measured widthout the bleedยซ

This could be appended to the description of the value in the API documentation.

columnDescription.png

1 Comment
Oli_Steadman
7 - App Architect
7 - App Architect

Very surprised to find this is not included in the API docs generated for my table and hopeful it will be introduced soon.