Adding DocBlock defaults for known Component props

Author: Josh Habdas

docs/app/Components/ComponentDoc/ComponentProps.js

@@ -1,6 +1,11 @@
 import _ from 'lodash';
 import React, {Component, PropTypes} from 'react';
-import {Segment, Table, TableColumn} from 'stardust';
+import {Header, Segment, Table, TableColumn} from 'stardust';
+
+const DOCBLOCK_DESCRIPTION_DEFAULTS = {
+  children: 'Body of the component.',
+  className: 'Class names for custom styling.',
+};
 
 /**
  * Displays a table of a Component's PropTypes.
@@ -34,7 +39,7 @@ export default class ComponentProps extends Component {
     const propsDefinition = this.props.props;
     const content = _.map(propsDefinition, (propConfig, propName) => {
       const name = propName;
-      const description = _.get(propConfig, 'docBlock.description');
+      const description = _.get(propConfig, 'docBlock.description') || DOCBLOCK_DESCRIPTION_DEFAULTS[name];
 
       const value = _.get(propConfig, 'type.value');
       let type = _.get(propConfig, 'type.name');
@@ -58,7 +63,7 @@ export default class ComponentProps extends Component {
 
     return (
       <Segment className='basic vertical'>
-        <h2 className='ui header'>Props</h2>
+        <Header.H2 className='ui header'>Props</Header.H2>
         <Table data={content} className='very basic'>
           <TableColumn dataKey='name' cellRenderer={this.nameRenderer} />
           <TableColumn dataKey='type' />

src/elements/Segment/Segment.js

@@ -11,9 +11,6 @@ export default class Segment extends Component {
      * Segment tag body content.
      */
     children: PropTypes.node,
-    /**
-     * Class name for custom styling.
-     */
     className: PropTypes.string,
     /**
      * Optional segment heading.

src/elements/Segment/Segments.js

@@ -9,12 +9,9 @@ import {ofComponentTypes} from 'src/utils/customPropTypes';
 export default class Segments extends Component {
   static propTypes = {
     /**
-     * Must be of type Segment, Segments, H1, H2, H3, H4, H5, H6, Subheading or Message.
+     * Must be of type Segment, Segments, H1, H2, H3, H4, H5, H6, Subheader or Message.
      */
     children: ofComponentTypes(['Segment', 'Segments', 'H1', 'H2', 'H3', 'H4', 'H5', 'H6', 'Subheader', 'Message']),
-    /**
-     * Class name for custom styling.
-     */
     className: PropTypes.string,
   };