Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Selenium: Update javadocs to actual state in the "CodenvyEditor" class #9115

Merged
merged 15 commits into from
Mar 19, 2018

Conversation

Ohrimenko1988
Copy link
Contributor

What does this PR do?

Update javadocs to actual state in the "CodenvyEditor" class.

What issues does this PR fix or reference?

Issue: #9085

Release Notes

Docs PR

@Ohrimenko1988 Ohrimenko1988 added status/code-review This issue has a pull request posted for it and is awaiting code review completion by the community. kind/task Internal things, technical debt, and to-do tasks to be performed. labels Mar 16, 2018
/**
* Waits until editor's tab with specified {@code nameOfFile} is closed.
*
* @param nameOfFile visible name of the editor's tab
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

did you mean title of tab?

@@ -596,7 +624,9 @@ private void openGoToLineFormAndSetCursorToPosition(int positionLine, int positi
askForValueDialog.waitFormToClose();
}

/** launch code assistant with ctrl+space keys and wait container is open */
/**
* Launches code assistant by "ctrl" + "space" keys combination and waits until container is open.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is opened? (passive voice)

@@ -657,7 +687,7 @@ public void waitMarkerInPosition(MarkerLocator markerLocator, int position) {
expectedNumberOfActiveLine(position);
}

/** Wait for no Git change markers in the opened editor. */
/** Waits for no Git change markers in the opened editor. */
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"No Git Change" markers is clearer.

@@ -670,7 +700,8 @@ public void waitNoGitChangeMarkers() {
}

/**
* Wait for Git insertion marker in the opened editor.
* Waits for Git insertion marker between {@code startLine} and {@code endLine} including this two
Copy link
Contributor

@dmytro-ndp dmytro-ndp Mar 16, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it could be written simpler: between the specified fromLine, inclusive, and toLine, inclusive.

public String getAllVisibleTextFromProposition() {
waitPropositionAssistContainer();
return seleniumWebDriverHelper.waitVisibilityAndGetText(propositionContainer);
}

/** wait assist proposition container is open */
/** Waits until assist proposition container is open. */
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is opened (Passive voice)

*/
public void waitActiveTabFileName(String nameOfFile) {
seleniumWebDriverHelper.waitPresence(By.xpath(format(ACTIVE_TAB_FILE_NAME, nameOfFile)));
}

/** check that files have been closed. (Check disappears all text areas and tabs) */
/** Checks that all files have been closed. (Checks disappears all text areas and tabs) */
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

disappears > disappearance of

@@ -1139,7 +1226,7 @@ public void selectLineAndDelete() {
typeTextIntoEditor(DELETE.toString());
}

/** Deletes current line with Ctrl+D */
/** Deletes current editor's line with Ctrl+D. */
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

with Ctrl+D > by Ctrl+D keys pressing

*
* @param position position of the breakpoint
* @param position number of line in which breakpoint should be placed
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

in which > where

}

/**
* select defined implementation in the 'Implementation' form
* Selects defined {@code itemName} in the 'Implementation' form
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

defined > specified

* Select tab by index of editor window after split
* Selects editor's tab by specified {@code index} and {@code tabName}.
*
* <p>Note! Is used for split editor.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is used for split editor. is not clear, as for me.

*
* @param selectedElement is the selected element into editor
* @param selectedElement visible text in the editor on which context click should be perform
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

be performed (Passive Voice)

@@ -1854,18 +2006,18 @@ public void openContextMenuOnElementInEditor(String selectedElement) {
waitContextMenu();
}

/** wait context menu form is open */
/** Waits until context menu form is open. */
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is opened

@Ohrimenko1988 Ohrimenko1988 merged commit 39e7ade into master Mar 19, 2018
@Ohrimenko1988 Ohrimenko1988 deleted the selen-editor-javadoc branch March 19, 2018 13:28
@Ohrimenko1988 Ohrimenko1988 removed the status/code-review This issue has a pull request posted for it and is awaiting code review completion by the community. label Mar 19, 2018
@benoitf benoitf added this to the 6.3.0 milestone Mar 19, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind/task Internal things, technical debt, and to-do tasks to be performed.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants