Best practices

This page outlines a few common best practices when building in Cinchy.

Naming convention

‌Cinchy is a simple, business user friendly application. This means that you should use business friendly terms to name your tables and columns. For example, you want to name a column Full Name rather than full_name, fullName, or fName.

Domains

‌Domains essentially act as folders to be able to organize your data. Most users will want to split domains by business lines, such as Sales, Marketing, and Human Resources. The key thing is to keep it consistent so users have a general idea where to go to find information.‌‌

Descriptions

‌You can add descriptions to your tables and columns. Descriptions lets users access data in a more self-serve fashion, and also helps prevent misunderstandings of the meaning of your data.‌‌ Table descriptions are shown in the My Network screen, and will show up in search as well.‌ (Image 1).

Image 1: Table Description

Column descriptions show up when you hover on the column in the Manage Data screen (Image 2 and 3).

Image 2: Column Descriptions
Image 3: Column Descriptions

Last updated