Skip to content

Commit

Permalink
Tweak some English-language documentation for clarity and correctness (
Browse files Browse the repository at this point in the history
…#1505)

* Edit _index.en.md for clarity

* Update options.en.md for clarity

* Update using_selenium.en.md

* Update locators.en.md

[deploy site]
  • Loading branch information
zacharyzollman committed Oct 20, 2023
1 parent f2790b8 commit 1e52298
Show file tree
Hide file tree
Showing 4 changed files with 12 additions and 13 deletions.
6 changes: 3 additions & 3 deletions website_and_docs/content/documentation/overview/_index.en.md
Expand Up @@ -8,8 +8,8 @@ aliases: ["/documentation/en/introduction/"]
---


Selenium is not just one tool or API
but it composes many tools.
Selenium is not just one tool or API;
it comprises many tools.

## WebDriver

Expand All @@ -18,7 +18,7 @@ are going to be using WebDriver APIs. [WebDriver](/documentation/webdriver)
uses browser automation APIs provided by browser vendors to control the browser and
run tests. This is as if a real user is operating the browser. Since
WebDriver does not require its API to be compiled with application
code; It is not intrusive. Hence, you are testing the
code, it is not intrusive. Hence, you are testing the
same application which you push live.


Expand Down
Expand Up @@ -613,7 +613,7 @@ when using _Element Send Keys_ with hidden file upload controls.
## proxy

A proxy server acts as an intermediary for
requests between a client and a server. In simple,
requests between a client and a server. In simple terms,
the traffic flows through the proxy server
on its way to the address you requested and back.

Expand Down
Expand Up @@ -138,8 +138,8 @@ textbox, using css.
{{< /tabpane >}}

## id
We can use the ID attribute available with element in a web page to locate it.
Generally the ID property should be unique for a element on the web page.
We can use the ID attribute of an element in a web page to locate it.
Generally the ID property should be unique for each element on the web page.
We will identify the Last Name field using it.

{{< tabpane langEqualsHeader=true >}}
Expand Down Expand Up @@ -172,8 +172,8 @@ We will identify the Last Name field using it.


## name
We can use the NAME attribute available with element in a web page to locate it.
Generally the NAME property should be unique for a element on the web page.
We can use the NAME attribute of an element in a web page to locate it.
Generally the NAME property should be unique for each element on the web page.
We will identify the Newsletter checkbox using it.

{{< tabpane langEqualsHeader=true >}}
Expand Down Expand Up @@ -207,7 +207,7 @@ We will identify the Newsletter checkbox using it.
## link text
If the element we want to locate is a link, we can use the link text locator
to identify it on the web page. The link text is the text displayed of the link.
In the HTML snippet shared, we have a link available, lets see how will we locate it.
In the HTML snippet shared, we have a link available, let's see how will we locate it.
{{< tabpane langEqualsHeader=true >}}
{{< badge-examples >}}
{{< tab header="Java" >}}
Expand Down Expand Up @@ -341,16 +341,15 @@ first name text box. Let us create locator for female radio button using xpath.
## Relative Locators

**Selenium 4** introduces Relative Locators (previously
called as _Friendly Locators_). These locators are helpful when it is not easy to construct a locator for
called _Friendly Locators_). These locators are helpful when it is not easy to construct a locator for
the desired element, but easy to describe spatially where the element is in relation to an element that does have
an easily constructed locator.

### How it works

Selenium uses the JavaScript function
[getBoundingClientRect()](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect)
to determine the size and position of elements on the page, and can use this information to locate neighboring elements.
find the relative elements.
to determine the size and position of elements on the page, and can use this information to locate neighboring elements.

Relative locator methods can take as the argument for the point of origin, either a previously located element reference,
or another locator. In these examples we'll be using locators only, but you could swap the locator in the final method with
Expand Down
Expand Up @@ -17,7 +17,7 @@ ideas for how to actually do productive things with your Selenium code.
## Common Uses

Most people use Selenium to execute automated tests for web applications,
but Selenium support any use case of browser automation.
but Selenium supports any use case of browser automation.

### Repetitive Tasks

Expand Down

0 comments on commit 1e52298

Please sign in to comment.