Skip to content
This repository has been archived by the owner on Sep 18, 2024. It is now read-only.

Improve grammar, spelling, and wording within the English documentation. #2223

Merged
merged 34 commits into from
Mar 24, 2020
Merged

Conversation

AHartNtkn
Copy link
Contributor

I found reading through much of the documentation to be pretty frustrating and decided to dedicate some time to fix some of it. This pull request covers the overview, installation, quickstart, most of hyperparameter tuning, and the overview, quickstart, and tutorial for the NAS. Originally, I wanted to cover more, but I lost interest in the face of other, more pressing projects. I figured I'd make a pull request for what's done so that work doesn't go to waste.

I cannot guarantee that every problem is fixed, but the covered docs are far more readable with these changes.

Fix a lot of akward or misleading phrasing.
Fix a few spelling errors.
Fixed past tence vs presen tense (can vs. could, supports vs supported)
Lots of akward phrasing.
Lots of tense issues (could vs can)
Lots of spelling errors (especcially "offical")
Lots of missing articles
Docker is a proper noun and should be capitalized
tab "something" should be the "something" tab.
Tense issues (e.g., Modified vs. Modify).
…verview

Lots of missing articles.
Swapped out "Example usage" for "Example config", because that's what it is. Usage isn't examplified at all.
I have no idea what the note at the end of the TPE section is trying to say, so I left it untouched, but it should be changed to something that make sense.
…ners

Fixed many incomplete sentences and bad wording.
The first sentence in the Parallel TPE optimization section doesn't make sense to me, but I left it in case it's supposed to be that way. That sentence was copied from the blog post.
@msftclas
Copy link

msftclas commented Mar 22, 2020

CLA assistant check
All CLA requirements met.

@xuehui1991
Copy link
Contributor

@AHartNtkn Thanks for the greate job!

image

image

I noticed that you change the "Requirement of classArg" into "classArgs requirements:" in the doc of the assessor, but in other docs of tuner, we still used the Requirement of classArg".
Could you help to change these to keep all formats consistent?

Thanks for your efforts.

@@ -23,15 +23,15 @@ tuner:
```

**Requirement of classArg**
Copy link
Contributor

Choose a reason for hiding this comment

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

comment here.

…wo files

tuner and builtin assessor.One instance in HyperoptTuner.md and BuiltinAssessor.md.
@xuehui1991 xuehui1991 merged commit 86a27f4 into microsoft:master Mar 24, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants