Documentation Update

Hi there!

Thanks for submitting an issue to Protractor.

To help us help you better, please do the following before submitting an issue:

1. Review the questions section of CONTRIBUTING.md.
2. Make sure you are not asking a usage or debugging question. If you are, use StackOverflow, Google Group discussion list, or Gitter to get help.
3. Provide a minimally reduced test case. This makes it much more likely that your bug will be fixed. Protractor has a test Angular application available at http://www.protractortest.org/testapp which you can use for the reproducible test case.
4. Fill in the information that corresponds to your type of issue below.
5. Delete this intro and any unrelated text 😄 (if you do not we'll assume you haven't read these instructions and automatically close the issue.)

Bug report

• Node Version: 15.x``
• Protractor Version: 6.x``
• Angular Version: ``
• Browser(s): Chrome
• Operating System and Version Win 7, 10, Mac
• Your protractor configuration file
• A relevant example test
• Output from running the test
• Steps to reproduce the bug
• The URL you are running your tests against (if relevant)

Feature Request

• Reasons for adopting new feature

Please update the public facing documentation, particularly the tutorial and the examples. Due to recent upgrades, the protractor newbies and user community should be made aware:

1. That the version selection process in webdriver-manager now points to the most recent version. It may not always be possible to synch with Chrome, so users should be advised how to specify a current and not a future version of the browser/driver. I do not know if this will affect other browser/drivers.

2. Due to the rise of async, Protractor 6.x and beyond require await/async. Newbies and people with long running scripts will not know this and will likely not look it up. Please change the tutorial and examples to reflect this.

• Is this a breaking change? (How will this affect existing functionality)

Yes, it will take users by surprise.

Cheers, RW
P.S. I'm out there trying to evangelize Protractor to the masses, so this will help considerably.

[cnishina]

Could you help and put in a PR for this? Thanks!

Will do.

[solvistas-dreswi]

Any progress here? The milestone is 3 months overdo now...