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.