diff --git a/docs/api/Shaders.create.md b/docs/api/Shaders.create.md
index b828469e596e82557e8faaa3c01c025562b43ba8..7d18386d8a1a0b3b95abe17703e995f8c8eb6c24 100644
--- a/docs/api/Shaders.create.md
+++ b/docs/api/Shaders.create.md
@@ -21,6 +21,12 @@ void main () {
 <GL.View shader={shaders.myEffect} ... />
 ```
 
+`GL.Shaders.create` is inspired from ReactNative's `StyleSheet.create`: it creates an object with key-value and will returns an object with the same keys and where the values can be used in the Virtual DOM.
+
+The value of each Shader is an object with a `frag` field: the fragment GLSL code.
+
+## About Shaders
+
 There are two kinds of OpenGL Shaders: vertex and fragment shaders.
 The vertex shader iterates over polygons and computes pixel positions, the fragment shaders iterates over pixels and computes a color.
 
@@ -30,6 +36,3 @@ and you only have to implement the fragment shader.
 > This documentation assumes you know the basics of GLSL, the OpenGL Shading Language, if not, feel free to learn [shader-school](https://www.npmjs.com/package/shader-school), read the [specification](https://www.opengl.org/documentation/glsl/) or learn from the examples.
 
 
-`GL.Shaders.create` is inspired from ReactNative's `StyleSheet.create`: it creates an object with key-value and will returns an object with the same keys and where the values can be used in the Virtual DOM.
-
-The value of each Shader is an object with a `frag` field: the fragment GLSL code.