-
Notifications
You must be signed in to change notification settings - Fork 25.6k
Spelling #37035
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
Spelling #37035
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm hoping this is a debugging object
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is just a section name, but it's possible things link to it
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This should be high, rather than height
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is just a section name, but it's possible things link to it
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is just a section name, but it's possible things link to it
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is just a section name, but it's possible things link to it
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is probably an api change
x-pack/plugin/watcher/src/main/java/org/elasticsearch/xpack/watcher/Watcher.java
Outdated
Show resolved
Hide resolved
...rg/elasticsearch/xpack/watcher/notification/email/attachment/HttpEmailAttachementParser.java
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Really not sure about this
...asticsearch/xpack/watcher/notification/email/attachment/HttpEmailAttachementParserTests.java
Outdated
Show resolved
Hide resolved
tvernum
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I tried to do a first pass on this, but really I think it is too big for us to ever actually get this merged.
I think I got about 2/3 of the way through it, and that was just glancing at each change looking for obvious problems.
Just doing to proper review of each change will take a couple of hours, and that's not accounting for looking into the changes that are questionable (many of which you've already highlighted).
By the time we reached a conclusion on all the changes, the code base would have moved so much that the merges would become ugly and someone would have to spend more time sorting that out.
If you want to see this to completion I think we need to get it split into manageable pieces. My recommendations:
- Start with anything in the docs because those have real value (and there's probably not many of them).
- Skip the
ie.->i.e.andeg.->e.g.; Yes it's technically correct, but there's a lot of them and it creates a lot of noise for very minimal value. - Split the API changes (class names, public method names) into separate PRs so that they can get 1 good review and be merged. e.g. one for each of the
isCacheableandInterruptiblechanges. - then let's see what's left over.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This should be high, rather than height
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The page it is linking to is https://www.elastic.co/guide/en/elasticsearch/guide/current/pluggable-similarites.html (which has a typo, but we can live with it).
Can you revert this change please?
|
|
||
| /** | ||
| * @deprecated new implementors should override {@link #read(StreamInput)} and use the | ||
| * @deprecated new implementers should override {@link #read(StreamInput)} and use the |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Strictly speaking both implementor and implementer are correct usage, so I'm not sure it's worth the churn to change these.
| throw new IllegalArgumentException("final " + type + " setting [" + key + "], not updatable"); | ||
| } else { | ||
| throw new IllegalArgumentException(type + " setting [" + key + "], not dynamically updateable"); | ||
| throw new IllegalArgumentException(type + " setting [" + key + "], not dynamically updatable"); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Strictly, both are correct, but our docs seem to prefer updatable, so this is probably a good change.
| @@ -277,14 +277,14 @@ public void testDefault() { | |||
|
|
|||
| // It gets more complicated when there are two settings objects.... | |||
| Settings hasFallback = Settings.builder().put("foo.bar", "o").build(); | |||
| Setting<String> fallsback = | |||
| Setting<String> fallsBack = | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If we're going to change this one, I think it should just be fallback
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I normally would have picked fallback, the only reason I didn't was that I was wondering if the code was trying to speak about the action of falling back as opposed to the actual fallback.
I'm quite happy to switch (and will when I get to the code side, I think that'll come after the API bits get split out).
|
Sure. |
|
For reference, |
|
I think this is as far as I'm likely to go today. |
|
thanks you @jsoref ! |
|
For my reference, the elasticsearch build system doesn't like my git metadata... The following works to strip the metadata (by recreating a branch's single commit w/ its single-line commit message): for a in $(cat); do
git checkout master;
git branch -D X;
git checkout -b X;
git show $a |patch -p1;
git add .;
git commit -m "$(git log --format=%B -n 1 $a|head -1)";
git diff $a..X &&
git branch -D $a &&
git checkout -b $a &&
git branch -D X &&
git push github $a -f;
done(yes, one of the two deletes of the X branch will fail, but that's just paranoia) |
Generated by https://github.com/jsoref/spelling
f; to maintain your repo, please considerfchurnfchurncan be used to deal w/ rebasing the last mile if people are interested.gradle check?