auto updated documentation

DavertMik · DavertMik · commit 9716f0c0c288 · 2018-02-27T01:36:52.000+02:00
diff --git a/changelog.markdown b/changelog.markdown
@@ -7,6 +7,26 @@ title: Codeception Changelog
 
 # Changelog
 
+#### 2.3.9
+
+* Added `Codeception\Step\Argument\PasswordArgument` to pass sensitive data into tests:
+
+```php
+<?php
+use \Codeception\Step\Argument\PasswordArgument;
+
+$I->amOnPage('/form/password_argument');
+$I->fillField('password', new PasswordArgument('thisissecret'));
+```
+
+* **[WebDriver]** added `clearField` method to clean up input fields by **[eknej](https://github.com/eknej)** 
+* **[DataFactory]** added `make` method to create instances without saving them to database. But **[ibpavlov](https://github.com/ibpavlov)** 
+* **[REST]** Fixed passing a file to `sendPOST()` without name, size or type parameter. BY **[zebraf1](https://github.com/zebraf1)**
+* **[REST]** Add missing / to relative url from config by **[bscheshirwork](https://github.com/bscheshirwork)** 
+* Fixed HTML Report marks tests as succeeded by **[mpgo13](https://github.com/mpgo13)**
+* `clean` command works recursively with included setups. By **[davidnewcomb](https://github.com/davidnewcomb)** 
+
+
 #### 2.3.8
 
 * `Codeception\Util\Stub` moved to standalone package [Codeception\Stub](https://github.com/Codeception/Stub):
diff --git a/docs/05-UnitTests.md b/docs/05-UnitTests.md
@@ -104,7 +104,7 @@ class UserTest extends \Codeception\Test\Unit
 
 ### Assertions
 
-There are pretty much assertions you can use inside tests. The most common are:
+There are pretty many assertions you can use inside tests. The most common are:
 
 * `$this->assertEquals()`
 * `$this->assertContains()`
diff --git a/docs/12-ParallelExecution.md b/docs/12-ParallelExecution.md
@@ -47,7 +47,7 @@ We prepared a sample config with codeception, web server, database, and selenium
 
 version: '2'
 services:
-  codeception:
+  codecept:
     image: codeception/codeception
     depends_on:
       - firefox
diff --git a/docs/modules/AngularJS.md b/docs/modules/AngularJS.md
@@ -399,6 +399,19 @@ $I->checkOption('#agree');
  * `param` $option
 
 
+#### clearField
+ 
+lears given field which isn't empty.
+
+`` php
+?php
+I->clearField('#username');
+>
+``
+
+param $field
+
+
 #### click
  
 Perform a click on a link or a button, given by a locator.
diff --git a/docs/modules/DataFactory.md b/docs/modules/DataFactory.md
@@ -41,7 +41,7 @@ $fm->define(User::class)->setDefinitions([
 
    // generate a profile and return its Id
    'profile_id' => 'factory|Profile'
-);
+]);
 
 {% endhighlight %}
 
@@ -63,7 +63,7 @@ modules:
 (you can also use Laravel5 and Phalcon).
 
 In this example factories are loaded from `tests/_support/factories` directory. Please note that this directory is relative from the codeception.yml file (so for Yii2 it would be codeception/_support/factories).
- * You should create this directory manually and create PHP files in it with factories definitions following [official documentation](https://github.com/thephpleague/factory-muffin#usage).
+You should create this directory manually and create PHP files in it with factories definitions following [official documentation](https://github.com/thephpleague/factory-muffin#usage).
 
 In cases you want to use data from database inside your factory definitions you can define them in Helper.
 For instance, if you use Doctrine, this allows you to access `EntityManager` inside a definition.
@@ -147,7 +147,7 @@ $I->have('User', ['is_active' => true]); // creates active user
 
 Returns an instance of created user.
 
- * `param` $name
+ * `param string` $name
  * `param array` $extraAttrs
 
  * `return` object
@@ -164,10 +164,31 @@ $I->haveMultiple('User', 10, ['is_active' => true]); // create 10 active users
 
 {% endhighlight %}
 
- * `param` $name
- * `param` $times
+ * `param string` $name
+ * `param int` $times
  * `param array` $extraAttrs
 
  * `return` \object[]
 
+
+#### make
+ 
+Generates a record instance.
+
+This does not save it in the database. Use `have` for that.
+
+{% highlight php %}
+
+$user = $I->make('User'); // return User instance
+$activeUser = $I->make('User', ['is_active' => true]); // return active user instance
+
+{% endhighlight %}
+
+Returns an instance of created user without creating a record in database.
+
+ * `param string` $name
+ * `param array` $extraAttrs
+
+ * `return` object
+
 <p>&nbsp;</p><div class="alert alert-warning">Module reference is taken from the source code. <a href="https://github.com/Codeception/Codeception/tree/2.3/src/Codeception/Module/DataFactory.php">Help us to improve documentation. Edit module reference</a></div>
diff --git a/docs/modules/WebDriver.md b/docs/modules/WebDriver.md
@@ -599,6 +599,19 @@ $I->checkOption('#agree');
  * `param` $option
 
 
+#### clearField
+ 
+lears given field which isn't empty.
+
+`` php
+?php
+I->clearField('#username');
+>
+``
+
+param $field
+
+
 #### click
  
 Perform a click on a link or a button, given by a locator.
diff --git a/docs/reference/Commands.md b/docs/reference/Commands.md
@@ -283,10 +283,9 @@ Generates StepObject class. You will be asked for steps you want to implement.
 
 ## Clean
 
-Cleans `output` directory
+Recursively cleans `output` directory and generated code.
 
 * `codecept clean`
-* `codecept clean -c path/to/project`
 
 
 
