diff --git a/src/core/ReadyButton.qml b/src/core/ReadyButton.qml
--- a/src/core/ReadyButton.qml
+++ b/src/core/ReadyButton.qml
@@ -22,17 +22,15 @@
 import GCompris 1.0
 
 Rectangle {
-    
-    
-    property string theme: "dark"
+    id: iAmReady
 
     /**
      * type:var
-     * existing themes for the button.
+     * Existing themes for the button.
      * A theme is composed of:
-     *   the button's border color
-     *   the text color
-    */
+     *   The button's border color
+     *   The text color
+     */
     property var themes: {
         "dark": {
             borderColor: "#FF373737",
@@ -48,9 +46,19 @@
         }
     }
 
-    
-    
-    id: iamReady
+    /**
+     * type: string
+     * Defines the theme of the ReadyButton - dark or light.
+     *
+     * Default theme is dark.
+     */
+    property string theme: "dark"
+
+    /**
+     * Emitted when the ReadyButton is clicked
+     */
+    signal clicked
+
     anchors.horizontalCenter: parent.horizontalCenter
     anchors.verticalCenter: parent.verticalCenter
     border.color: themes[theme].borderColor
@@ -64,7 +72,6 @@
             GradientStop { position: 0 ; color: themes[theme].fillColor0 }
             GradientStop { position: 1 ; color: themes[theme].fillColor1 }
         }
-    signal clicked
 
     GCText {
         id: iamReadyText