Skip to content

Commit 1e52298

Browse files
Tweak some English-language documentation for clarity and correctness (SeleniumHQ#1505)
* Edit _index.en.md for clarity * Update options.en.md for clarity * Update using_selenium.en.md * Update locators.en.md [deploy site]
1 parent f2790b8 commit 1e52298

File tree

4 files changed

+12
-13
lines changed

4 files changed

+12
-13
lines changed

website_and_docs/content/documentation/overview/_index.en.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ aliases: ["/documentation/en/introduction/"]
88
---
99

1010

11-
Selenium is not just one tool or API
12-
but it composes many tools.
11+
Selenium is not just one tool or API;
12+
it comprises many tools.
1313

1414
## WebDriver
1515

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

2424

website_and_docs/content/documentation/webdriver/drivers/options.en.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -613,7 +613,7 @@ when using _Element Send Keys_ with hidden file upload controls.
613613
## proxy
614614

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

website_and_docs/content/documentation/webdriver/elements/locators.en.md

+7-8
Original file line numberDiff line numberDiff line change
@@ -138,8 +138,8 @@ textbox, using css.
138138
{{< /tabpane >}}
139139

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

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

173173

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

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

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

348348
### How it works
349349

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

355354
Relative locator methods can take as the argument for the point of origin, either a previously located element reference,
356355
or another locator. In these examples we'll be using locators only, but you could swap the locator in the final method with

website_and_docs/content/documentation/webdriver/getting_started/using_selenium.en.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ideas for how to actually do productive things with your Selenium code.
1717
## Common Uses
1818

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

2222
### Repetitive Tasks
2323

0 commit comments

Comments
 (0)