Release 3.3.7 (#3506)

* updated docs

* version bump

* added changelog, improved docs

* Update typescript.md

Co-authored-by: Peter Ng <peter.nguyentr@gmail.com>

Author: DavertMik

CHANGELOG.md

@@ -1,10 +1,44 @@
+## 3.3.7
+
+🛩️ Features
+
+* **Promise-based typings** for TypeScript definitions in #3465 by @nlespiaucq. If you use TypeScript or use linters [check how it may be useful to you](https://bit.ly/3XIMq6n).
+* **Translation** improved to use [custom vocabulary](https://codecept.io/translation/). 
+* [Playwright] Added methods in #3398 by @mirao
+  * `restartBrowser` - to restart a browser (with different config)
+  * `_createContextPage` - to create a new browser context with a page from a helper
+* Added [Cucumber custom types](/bdd#custom-types) for BDD in #3435 by @Likstern 
+* Propose using JSONResponse helper when initializing project for API testing. #3455 by @PeterNgTr 
+* When translation enabled, generate tests using localized aliases. By @davertmik
+
+🐛 Bugfixes
+
+* Fixed #3462 `TypeError: Cannot read properties of undefined (reading 'setStatus')` by @dwentland24 in #3438
+* Fixed creating steps file for TypeScript setup #3459 by @PeterNgTr 
+* Fixed issue of after all event in `run-rerun` command after complete execution #3464 by @jain-neeeraj 
+* [Playwright][WebDriver][Appium] Do not change `waitForTimeout` value on validation. See #3478 by @pmajewski24. Fixes #2589
+* [Playwright][WebDriver][Protractor][Puppeteer][TestCafe] Fixes `Element "{null: undefined}" was not found` and `element ([object Object]) still not present` messages when using object locators. See #3501 and #3502 by @pmajewski24
+* [Playwright] Improved file names when downloading file in #3449 by @PeterNgTr. Fixes #3412 and #3409
+* Add default value to `profile` env variable. See #3443 by @dwentland24. Resolves #3339
+* [Playwright] Using system-native path separator when saving artifacts in #3460 by @PeterNgTr
+* [Playwright] Saving videos and traces from multiple sessions in #3505 by @davertmik
+* [Playwright] Fixed `amOnPage` to navigate to `about:blank` by @zaxoavoki in #3470 Fixes #2311
+* Various typing improvements by @AWolf81 @PeterNgTr @mirao  
+
+📖 Documentation
+
+* Updated [Auickstart](https://codecept.io/quickstart/) with detailed explanation of questions in init
+* Added [Translation](/translations/) guide
+* Updated [TypeScript](https://bit.ly/3XIMq6n) guide for promise-based typings
+* Reordered guides list on a website
+
 ## 3.3.6
 
 * [`run-rerun`](https://codecept.io/commands/#run-rerun) command was re-introduced by @dwentland24 in #3436. Use it to perform run multiple times and detect flaky tests
 * Enabled `retryFailedStep` by default in `@codeceptjs/configure` v 0.10. See https://github.com/codeceptjs/configure/pull/26
 * [Playwright] Fixed properties types "waitForNavigation" and "firefox" by @mirao in #3401
 * [REST] Changed "endpoint" to optional by @mirao in #3404
-* [REST] Use [`secret`]() for form encoded string by @PeterNgTr:
+* [REST] Use [`secret`](/secrets) for form encoded string by @PeterNgTr:
 
 ```js
 const secretData = secret('name=john&password=123456');

docs/basics.md

@@ -23,14 +23,14 @@ The `I` object is an **actor**, an abstraction for a testing user. The `I` is a
 
 ## Architecture
 
-CodeceptJS bypasses execution commands to helpers. Depending on the helper enabled, your tests will be executed differently. If you need cross-browser support you should choose Selenium-based WebDriver or TestCafé. If you are interested in speed - you should use Chrome-based Puppeteer.
+CodeceptJS bypasses execution commands to helpers. Depending on the helper enabled, your tests will be executed differently.
 
 The following is a diagram of the CodeceptJS architecture:
 
 ![architecture](/img/architecture.png)
 
 All helpers share the same API, so it's easy to migrate tests from one backend to another.
-However, because of the difference in backends and their limitations, they are not guaranteed to be compatible with each other. For instance, you can't set request headers in WebDriver or Protractor, but you can do so in Puppeteer or Nightmare.
+However, because of the difference in backends and their limitations, they are not guaranteed to be compatible with each other. For instance, you can't set request headers in WebDriver but you can do so in Playwright or Puppeteer.
 
 **Pick one helper, as it defines how tests are executed.** If requirements change it's easy to migrate to another.
 

docs/helpers/GraphQL.md

@@ -93,9 +93,9 @@ I.sendMutation(`
 #### Parameters
 
 -   `mutation` **[String][3]** 
--   `variables` **[object][2]** that may go along with the mutation
--   `options` **[object][2]** are additional query options 
--   `headers` **[object][2]**  
+-   `variables` **[object][2]?** that may go along with the mutation
+-   `options` **[object][2]?** are additional query options 
+-   `headers` **[object][2]?**  
 
 Returns **any** Promise<any>
 
@@ -117,9 +117,9 @@ const user = response.data.data;
 #### Parameters
 
 -   `query` **[String][3]** 
--   `variables` **[object][2]** that may go along with the query
--   `options` **[object][2]** are additional query options 
--   `headers` **[object][2]**  
+-   `variables` **[object][2]?** that may go along with the query
+-   `options` **[object][2]?** are additional query options 
+-   `headers` **[object][2]?**  
 
 Returns **any** Promise<any>