@graphenedata/cli 0.0.10 → 0.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,18 @@
1
+ # RULES
2
+
3
+ **When formulating GSQL queries:**
4
+ - First check all available stored expressions to see if there are any you can use. DO NOT redefine important business definitions like `profit` if they've already been modeled!
5
+ - Run your GSQL queries in the CLI first, _before_ you write them to a file. This way you can reason about the results to make sure they make sense.
6
+
7
+ **When writing to a .gsql file:**
8
+ - ALWAYS check your code with `npm run graphene check`.
9
+
10
+ **When writing to a Graphene .md file:**
11
+ - ALWAYS check your code with `npm run graphene check [mdPath]`. Run the command with full permissions because the screenshot may not work in a sandbox.
12
+ - If `check` is successful, it will save a screenshot. Look at the screenshot and critique what you see:
13
+ - Are all the data values and axes labels formatted in a way that is easy to read?
14
+ - Does the shape of the visualized data require an adjustment to scale, axis min/max, axis split, etc.?
15
+ - Are metrics colored consistently across visualizations?
16
+ - Are any visualizations missing data altogether?
17
+ - Is that visualization type really the best way to illustrate the data?
18
+ - Are any visualizations redundant? Can you say the same thing with less?