WIP

Author: ngokevin

docs/primitives/common-attributes.md

@@ -1,16 +1,19 @@
 ---
-title: Material Attributes
+title: Common Attributes
 type: primitives
 layout: docs
 parent_section: primitives
 order: 2
 ---
 
-Many of the primitives are entities that compose a geometric mesh, meaning they primarily prescribe the [geometry](../components/geometry.md) and [material](../components.material.md) components. Most of the mesh primitives share common attributes, especially for mapping to the material component. These common attributes won't be described in individual documentation pages for each primitive so they will be listed here.
+Many of the primitives they primarily prescribe the [geometry][geometry] and
+[material][material] components to create a mesh. All of the mesh primitives
+share common attributes relating to material component.
 
 ## Example
 
-`<a-box>`, `<a-cylinder>`, `<a-sphere>` are some primitives that prescribe a geometric mesh. They share common attributes relating to the material component:
+`<a-box>`, `<a-cylinder>`, `<a-sphere>` are some primitives that represent a
+mesh. They share common attributes relating to the material component:
 
 ```html
 <a-box opacity="0.5" shader="flat" src="dirt.png"></a-box>
@@ -20,6 +23,9 @@ Many of the primitives are entities that compose a geometric mesh, meaning they
 
 ## Attributes
 
+When noted in the individual primitive documentation pages, these attributes
+will also be available to the primitive.
+
 | Attribute   | Component Mapping    | Default Value |
 |-------------|----------------------|---------------|
 | color       | material.color       | gray          |
@@ -29,3 +35,6 @@ Many of the primitives are entities that compose a geometric mesh, meaning they
 | shader      | material.shader      | standard      |
 | src         | material.src         | None          |
 | transparent | material.transparent | true          |
+
+[geometry]: ../components/geometry.md
+[material]: ../components/material.md