From 46fcc22672869059b209afdeaa6a1fc968bf351c Mon Sep 17 00:00:00 2001
From: Nedyalko Nikolov <nedyalko.nikolov@telerik.com>
Date: Wed, 4 Mar 2015 14:49:14 +0200
Subject: [PATCH] Added some links to ApiReference.

---
 apps/tests/layouts/absolute-layout-tests.ts   |  2 +-
 apps/tests/layouts/grid-layout-tests.ts       | 30 ++++++++++++++-----
 apps/tests/ui/page/page-tests-common.ts       |  5 ----
 ui/editable-text-base/editable-text-base.d.ts |  6 ++--
 ui/image/image.d.ts                           |  2 +-
 5 files changed, 28 insertions(+), 17 deletions(-)

diff --git a/apps/tests/layouts/absolute-layout-tests.ts b/apps/tests/layouts/absolute-layout-tests.ts
index 7f763469f..4031a1118 100644
--- a/apps/tests/layouts/absolute-layout-tests.ts
+++ b/apps/tests/layouts/absolute-layout-tests.ts
@@ -23,7 +23,7 @@ export var testAll = function () {
     absoluteLayout.height = 230;
     absoluteLayout.style.backgroundColor = new colorModule.Color("LightGray");
     var label;
-    // Left Top
+    //// In absolute layout place of an UI element is determined by 4 parameters : left, top, width and height.
     label = new labelModule.Label();
     label.width = 100;
     label.height = 100;
diff --git a/apps/tests/layouts/grid-layout-tests.ts b/apps/tests/layouts/grid-layout-tests.ts
index 26827a1d2..2bd9e018c 100644
--- a/apps/tests/layouts/grid-layout-tests.ts
+++ b/apps/tests/layouts/grid-layout-tests.ts
@@ -498,18 +498,18 @@ export function test_GridLayout_padding() {
 export var test_codesnippets = function () {
     // <snippet module="ui/layouts/grid-layout" title="grid-layout">
     // ## GridLayout sample
-    // ### Create GridLayout with 3 columns - 80px, *, auto size and 2 rows - 100px and auto size
-
+    // ### Creating Grid Layout via code.
     // ``` JavaScript
+    //var layout = require("ui/layouts/grid-layout");
     var gridLayout = new layout.GridLayout();
+    //  ```
+
+    // ### Add views to grid layout
+    // ``` JavaScript
     var btn1 = new button.Button();
     var btn2 = new button.Button();
     var btn3 = new button.Button();
     var btn4 = new button.Button();
-    //  ```
-
-    // ### Add views to layout
-    // ``` JavaScript
     gridLayout.addChild(btn1);
     gridLayout.addChild(btn2);
     gridLayout.addChild(btn3);
@@ -533,12 +533,17 @@ export var test_codesnippets = function () {
     layout.GridLayout.setColumnSpan(btn4, 3);
     // ```
 
-    // ### Create ItemSpec for columns and rows
+    // ### Create ItemSpec for columns and rows 3 columns - 80px, *, auto size and 2 rows - 100px and auto size
     // ``` JavaScript
+    //// ItemSpec modes of the column refers to its width.
+    //// Absolute size of the column
     var firstColumn = new layout.ItemSpec(80, layout.GridUnitType.pixel);
+    //// Star width means that this column will expand to fill the gap left from other columns
     var secondColumn = new layout.ItemSpec(1, layout.GridUnitType.star);
+    //// Auto size means that column will expand or shrink in order to give enough place for all child UI elements.
     var thirdColumn = new layout.ItemSpec(1, layout.GridUnitType.auto);
 
+    //// Star and Auto modes for rows behave like corresponding setting for columns but refer to row height.
     var firstRow = new layout.ItemSpec(1, layout.GridUnitType.auto);
     var secondRow = new layout.ItemSpec(1, layout.GridUnitType.star);
     // ```
@@ -551,5 +556,16 @@ export var test_codesnippets = function () {
     gridLayout.addRow(firstRow);
     gridLayout.addRow(secondRow);
     // ```
+
+    // ### Create same grid layout with an xml declaration
+    // ``` XML
+    // <GridLayout columns="80, *, auto" rows="auto, *" >
+    //  <Button col="0" />
+    //  <Button col="1" />
+    //  <Button col="2" />
+    //// by default column and row are set to 0
+    //  <Button row="1" colSpan="3" />
+    // </GridLayout>
+    // ```
     // </snippet>
 };
\ No newline at end of file
diff --git a/apps/tests/ui/page/page-tests-common.ts b/apps/tests/ui/page/page-tests-common.ts
index 231bb46f2..a184bbbf5 100644
--- a/apps/tests/ui/page/page-tests-common.ts
+++ b/apps/tests/ui/page/page-tests-common.ts
@@ -280,12 +280,7 @@ export var test_cssShouldBeAppliedToAllNestedElements = function () {
         StackLayout = new stackLayoutModule.StackLayout();
         StackLayout.addChild(label);
         testPage.content = StackLayout;
-        //<snippet module="ui/page" title="Page">
-        //### Adding a css that affects all nested UI components.
-        //``` JavaScript
         testPage.css = "stackLayout {background-color: #ffff0000;} label {background-color: #ff00ff00;}";
-        //```
-        //</snippet>
         return testPage;
     };
 
diff --git a/ui/editable-text-base/editable-text-base.d.ts b/ui/editable-text-base/editable-text-base.d.ts
index 97bf73de5..5aa4b0dc9 100644
--- a/ui/editable-text-base/editable-text-base.d.ts
+++ b/ui/editable-text-base/editable-text-base.d.ts
@@ -14,12 +14,12 @@
         constructor(options?: Options);
 
         /**
-         * Gets or sets the soft keyboard type.
+         * Gets or sets the soft keyboard type. Possible values are contained in the [KeyboardType enumeration](../enums/KeyboardType/README.md).
          */
         keyboardType: string;
 
         /**
-         * Gets or sets the soft keyboard return key flavor.
+         * Gets or sets the soft keyboard return key flavor. Possible values are contained in the [ReturnKeyType enumeration](../enums/ReturnKeyType/README.md).
          */
         returnKeyType: string;
 
@@ -30,7 +30,7 @@
 
         /**
          * Gets or sets a value indicating when the text property will be updated. 
-         * Possible values are contained in the UpdateTextTrigger enumeration located in "ui/enums" module.
+         * Possible values are contained in the [UpdateTextTrigger enumeration](../enums/UpdateTextTrigger/README.md).
          */
         updateTextTrigger: string;
         
diff --git a/ui/image/image.d.ts b/ui/image/image.d.ts
index eebdc319f..3ee89ff8d 100644
--- a/ui/image/image.d.ts
+++ b/ui/image/image.d.ts
@@ -61,7 +61,7 @@ declare module "ui/image" {
         url: string;
 
         /**
-         * Gets or sets the image stretch mode.
+         * Gets or sets the image stretch mode. Possible values are contained in the [Stretch enumeration](../enums/Stretch/README.md).
          */
         stretch: string;
     }