docs(modeling): minor improvements

Author: hassankhan

docs/content/Schema/Fundamentals/Syntax.mdx

@@ -89,9 +89,7 @@ cube(`orders`, {
 cubes:
   - name: orders
     sql: >
-      SELECT *
-      FROM orders, line_items
-      WHERE orders.id = line_items.order_id
+      SELECT * FROM orders, line_items WHERE orders.id = line_items.order_id
 ```
 
 </CodeTabs>
@@ -103,7 +101,9 @@ YAML syntax is very similar to JavaScript syntax, with a few key differences:
 - In YAML syntax, cubes, views, and context variables should be wrapped in `{}`,
   e.g., `{FILTER_PARAMS.orders.created_at.filter('created_at')}`.
 - In YAML syntax, string values only need to have quotes around them if they
-  contain special values, e.g., `"{CUBE}.user_id = {users.id}"`.
+  contain special values, e.g., `"{CUBE}.user_id = {users.id}"`. Special values
+  include references to `CUBE` and other declared cubes, `FILTER_PARAMS`,
+  `COMPILE_CONTEXT`, and `SECURITY_CONTEXT`.
 
 [self-folder-structure]: #folder-structure
 [self-naming]: #naming

docs/content/Schema/Reference/cube.mdx

@@ -12,8 +12,7 @@ redirect_from:
 
 A `cube` represents a table of data in Cube. Cubes are typically declared in
 separate files with one cube per file. Within each cube are definitions of
-measures, dimensions, and joins between cubes. A cube should always be declared
-with a capital letter.
+measures, dimensions, and joins between cubes.
 
 <CodeTabs>