docs(forms): migrate @whatItDoes tags to the description (#23186)

We get the overview for the doc by splitting off the first
paragraph.

PR Close #23186
This commit is contained in:
Pete Bacon Darwin
2018-04-05 11:02:42 +01:00
committed by Igor Minar
parent 0a065bbdcf
commit 1aef4df127
12 changed files with 54 additions and 50 deletions

View File

@ -12,14 +12,14 @@ import {AsyncValidatorFn, ValidatorFn} from './directives/validators';
import {AbstractControl, FormArray, FormControl, FormGroup} from './model';
/**
* @whatItDoes Creates an {@link AbstractControl} from a user-specified configuration.
* @description
*
* It is essentially syntactic sugar that shortens the `new FormGroup()`,
* Creates an {@link AbstractControl} from a user-specified configuration.
*
* This is essentially syntactic sugar that shortens the `new FormGroup()`,
* `new FormControl()`, and `new FormArray()` boilerplate that can build up in larger
* forms.
*
* @description
*
* To use, inject `FormBuilder` into your component class. You can then call its methods
* directly.
*