docs(cldr): improve on the layout

Author: Desislava Mihaylova

docs/cldr/api.md

@@ -24,7 +24,7 @@ The CLDR data to be loaded. Multiple parameters are accepted.
 
 ## firstDay Method
 
-Returns the first day index starting from Sunday based on the specified locale.
+Returns the first day index starting from Sunday and based on the specified locale.
 
 ### firstDay Parameters
 
@@ -54,25 +54,39 @@ The options that determine the returned names.
 
 #### options.type `String`
 
-The type of the names. The supported values are `"eras"`, `"quarters"`, `"months"`, `"days"` and `"dayPeriods"`.
+The type of the names.
+
+The supported values are:
+* `"eras"`
+* `"quarters"`
+* `"months"`
+* `"days"`
+* `"dayPeriods"`
 
 #### options.nameType `String`
 
-The format name type. The supported values are `"abbreviated"`, `"wide"`, `"narrow"`. `"short"` can also be specified for `days`.
+The format name type.
+
+The supported values are:
+* `"abbreviated"`
+* `"wide"`
+* `"narrow"`
+
+The `"short"` option can also be specified for `days`.
 
 #### options.standAlone `Boolean`
 
-Indicates whether the stand-alone names should be returned.
+Indicates whether the standalone names should be returned.
 
 ### dateFormatNames Return Value
 
 #### Returns `Object|Array`
 
-The names. An object will be returned it the type is `"dayPeriods"` or `"eras"`. For the other types the result is `Array`.
+The names. An object will be returned if the type is `"dayPeriods"` or `"eras"`. For the other types, the result is `Array`.
 
 ## numberSymbols Method
 
-Returns the number symbols from specified locale.
+Returns the number symbols from the specified locale.
 
 ### numberSymbols Parameters
 
@@ -84,4 +98,4 @@ The locale id.
 
 #### Returns `Object`
 
-An object holding the locale number symbols.
+An object holding the number symbols from the specified locale.