-
Notifications
You must be signed in to change notification settings - Fork 997
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
[Tracking] Code Spell-Checking Sprint #11984
Comments
I have done this to all the VB code except possibly the 2 spaces after periods and 100% sentences with period in XML comments. The biggest offender is the resource and language files which I am not comfortable changing. Also missing "see" attribute in XML Comments (how many and when). What about changing attr to attribute in local names and other misspellings in local variables? VS considers anything 4 characters or longer misspelled if it's not in the dictionary. For words with special meaning/casing/spelling is there a way in a repo to add to spell checker? I will take on finishing the VB code if no one else wants to when exact scope is clear. |
@merriemcgaw how do I volunteer? I would like to try 1, There are two things that are easy to do, change local variable like attr to attribute (154 occurrences) it would include typeattr to typeAttribute and changing behaviour in behavior (29 occurrences) in comments. Also changing period with 2 spaces to period and 1 space. Another issue causing a lot suggestions is below, I have no idea how to fix, should I just open a new issue?
|
@paul1956 please go ahead and open a separate issue for the message above. And I think you just volunteered 😉 |
@merriemcgaw i will open the separate issue a namespace warning but not volunteering as its a C# issue and solving it is way beyond my C# skills. I will open 2 separate issues (if necessary) on attrib and 2 spaces after period and volunteer for those. Also the biggest use of 2 periods after space is resource strings, I assume you don’t want me to touch those. Where does one open issues about the Repo, none of the public issues seem to fit? |
@merriemcgaw C# has quoted strings with 2 periods after space. I think that is a separate issue that need to be opened. Also, XML Summy comments that are extremely long and don't wrap at column 120. |
@paul1956 I think you're right. Let's open a tracking issue on the content of quoted strings because I think that will take a bit more to do just right. |
@merriemcgaw What do you want done about period space end-of-line or before XML comment close tag, some but not all, of these might be an artifact of period 2 spaces XML Close tag being corrected. Need to be careful because these also exist in Code/Tests so its a manual process. |
…ellings part of #11984 (#12028) * Replaved period 2 spaces with period 1 space Fixed a few obvious spelling errors These shanges should only should ONLY be in comments, there are still 34 places in code and many in Resource files * Undo accidential code change and wrong spelling fix. * Correct selling of winform and re-entrancy * Fix 8 files that were incorrectly changed from period space to just period * Update src/System.Windows.Forms/src/System/Windows/Forms/Layout/TableLayout.cs Co-authored-by: Tanya Solyanik <[email protected]> * PR Feedbak --------- Co-authored-by: Tanya Solyanik <[email protected]>
@merriemcgaw "Microsoft" is spelled as "microsoft" throughout repo (~663 URLS) as are some other words as part of a URL, URLs are (mostly) lower case and then in the display string where word is detected as misspelled, is also lower case. As part of a URL, it is not spell checked but as the display string it is. I see 3 options.
|
I think your recommendation makes the most sense here. Let's do it. |
2 reviewers (@Epica3055 and @lonitra ) suggested I am fine with any decision; I will go back at the end and do 1 PR to fix them all to whatever you want. |
@paul1956 - would you be interested to do a pass over the comments to ensure XML tags are used where needed https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/xmldoc/recommended-tags |
@Tanya-Solyanik yes but I need more information, on what you are looking for. Lists for example might be supported but they are really hard for a human to read. Adding "See" would be interesting but there is little guidance for how often it should be used (first occurrence only, every occurrence). |
@Tanya-Solyanik I realized I spent so much time on shorting C# lines, my Regex missed VB. I will do that later to avoid merge issues. |
Related to #11984 --------- Co-authored-by: Tanya Solyanik <[email protected]>
@Tanya-Solyanik there are still many spelling issues. I got many of the ones in comments but not the ones involving private C# variables. |
This is an approach suggestion for now, please feel free to comment.
Comments and variables in the source code still contain a LOT of typos or weird "spelling variations".
I would suggest, we create a list of areas (doing it all at the same time is WAY too invasive of course) for tracking, and then put the sub issues derived from that out there up-for-grabs, after we've defined, how we want to tackle this. Here is a rule list as a first suggestion:
camelcAsenAming
(camelCaseNaming
), but do not introduce camel case naming, unless you can answer "What would @JeremyKuhne or @lonitra do" confidently: The reason is, that we have a lot of Win32 API calls in the repo, and those variables have a naming standard which consist of a lot weird abbreviations and in addition is often just not camelCase, and not even camelCaseIsh.protected
,internal
(Friend
),virtual
(Overridable
) let alonepublic
. If there is an obvious typo in such a member, please create a new issue so we can discuss, if we want to touch it (sometimes even changing an Internal member can be a breaking change, since ... you know ... Reflection...).@Olina-Zhang, once we finalize this item and know what we want to do, we should take it over to the Designer repo, and - as suggestion - do the same?
The text was updated successfully, but these errors were encountered: