Docs: Minor corrections.

ckeditor · Jan 24, 2020 · b488001 · b488001
1 parent 4674ba4
commit b488001
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 3 deletions.
diff --git a/src/view/styles/utils.js b/src/view/styles/utils.js
@@ -146,7 +146,8 @@ export function getBoxSidesValueReducer( styleShorthand ) {
 }
 
 /**
- * Returns a proper 1-to-4 value of a CSS [shorthand](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties) notation.
+ * Returns a [shorthand](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties) notation
+ * of a CSS property value.
  *
  *		getBoxSidesShorthandValue( { top: '1px', right: '1px', bottom: '2px', left: '1px' } );
  *		// will return '1px 1px 2px'

diff --git a/src/view/stylesmap.js b/src/view/stylesmap.js
@@ -887,14 +887,22 @@ function appendStyleValue( stylesObject, nameOrPath, valueOrObject ) {
  */
 
 /**
- * An object describing box sides values.
+ * An object describing values associated with the sides of a box, for instance margins, paddings,
+ * border widths, border colors, etc.
  *
  *		const margin = {
  *			top: '1px',
  *			right: '3px',
  *			bottom: '3px',
  *			left: '7px'
- *		}
+ *		};
+ *
+ *		const borderColor = {
+ *			top: 'red',
+ *			right: 'blue',
+ *			bottom: 'blue',
+ *			left: 'red'
+ *		};
  *
  * @typedef {Object} module:engine/view/stylesmap~BoxSides
  *