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

fix: Renamed spec files and incorrect cSpell ignores #12584

Merged
merged 1 commit into from
Mar 16, 2021

Conversation

nschonni
Copy link
Contributor

@nschonni nschonni commented Jan 24, 2021

MSFT employees can try out our new experience at OpenAPI Hub - one location for using our validation tools and finding your workflow.

Changelog

Please ensure to add changelog with this PR by answering the following questions.

  1. What's the purpose of the update?
    • new service onboarding
    • new API version
    • update existing version for new feature
    • update existing version to fix swagger quality issue in s360
    • Other, please clarify
  2. When you are targeting to deploy new service/feature to public regions? Please provide date, or month to public if date is not available yet.
  3. When you expect to publish swagger? Please provide date, or month to public if date is not available yet.
  4. If it's an update to existing version, please select SDKs of specific language and CLIs that require refresh after swagger is published.
    • SDK of .NET (need service team to ensure code readiness)
    • SDK of Python
    • SDK of Java
    • SDK of Js
    • SDK of Go
    • PowerShell
    • CLI
    • Terraform
    • No, no need to refresh for updates in this PR

Contribution checklist:

If any further question about AME onboarding or validation tools, please view the FAQ.

ARM API Review Checklist

  • Ensure to check this box if one of the following scenarios meet updates in the PR, so that label “WaitForARMFeedback” will be added automatically to involve ARM API Review. Failure to comply may result in delays for manifest application. Note this does not apply to data plane APIs, all “removals” and “adding a new property” no more require ARM API review.

    • Adding new API(s)
    • Adding a new API version
    • Adding a new service
  • Please ensure you've reviewed following guidelines including ARM resource provider contract and REST guidelines. Estimated time (4 hours). This is required before you can request review from ARM API Review board.

  • If you are blocked on ARM review and want to get the PR merged with urgency, please get the ARM oncall for reviews (RP Manifest Approvers team under Azure Resource Manager service) from IcM and reach out to them.

Breaking Change Review Checklist

If there are following updates in the PR, ensure to request an approval from API Review Board as defined in the Breaking Change Policy.

  • Removing API(s) in stable version
  • Removing properties in stable version
  • Removing API version(s) in stable version
  • Updating API in stable version with Breaking Change Validation errors
  • Updating API(s) in preview over 1 year

Action: to initiate an evaluation of the breaking change, create a new intake using the template for breaking changes. Addition details on the process and office hours are on the Breaking change Wiki.

Please follow the link to find more details on PR review process.

@openapi-workflow-bot
Copy link

Hi, @nschonni Thanks for your PR. I am workflow bot for review process. Here are some small tips.

  • Please ensure to do self-check against checklists in first PR comment.
  • PR assignee is the person auto-assigned and responsible for your current PR reviewing and merging.
  • For specs comparison cross API versions, Use API Specs Comparison Report Generator
  • If there is CI failure(s), to fix CI error(s) is mandatory for PR merging; or you need to provide justification in PR comment for explanation. How to fix?

  • Any feedback about review process or workflow bot, pls contact swagger and tools team. [email protected]

    @openapi-pipeline-app
    Copy link

    openapi-pipeline-app bot commented Jan 24, 2021

    Swagger Validation Report

    ️️✔️BreakingChange succeeded [Detail] [Expand]
    There are no breaking changes.
    ️️✔️LintDiff succeeded [Detail] [Expand]
    Validation passes for LintDiff.
    ️️✔️Avocado succeeded [Detail] [Expand]
    Validation passes for Avocado.
    ️️✔️ModelValidation succeeded [Detail] [Expand]
    Validation passes for ModelValidation.
    ️️✔️SemanticValidation succeeded [Detail] [Expand]
    Validation passes for SemanticValidation.
    ️️✔️[Staging] Cross Version BreakingChange (Base on preview version) succeeded [Detail] [Expand]
    There are no breaking changes.
    ️️✔️[Staging] Cross Version BreakingChange (Base on stable version) succeeded [Detail] [Expand]
    There are no breaking changes.
    ️️✔️CredScan succeeded [Detail] [Expand]
    There is no credential detected.
    ️️✔️[Staging] SDK Track2 Validation succeeded [Detail] [Expand]
    Validation passes for SDKTrack2Validation
    ️️✔️[Staging] PrettierCheck succeeded [Detail] [Expand]
    Validation passes for PrettierCheck.
    ️️✔️[Staging] SpellCheck succeeded [Detail] [Expand]
    Validation passes for SpellCheck.
    Posted by Swagger Pipeline | How to fix these errors?

    @openapi-pipeline-app
    Copy link

    openapi-pipeline-app bot commented Jan 24, 2021

    Swagger pipeline restarted successfully, please wait for status update in this comment.

    @ghost ghost added the customer-reported Issues that are reported by GitHub users external to the Azure organization. label Jan 24, 2021
    @ghost
    Copy link

    ghost commented Jan 24, 2021

    Thank you for your contribution nschonni! We will review the pull request and get back to you soon.

    @nschonni nschonni force-pushed the renamed-ignored-cspell branch from 6caab09 to f8d0f05 Compare January 25, 2021 03:05
    cSpell.json Outdated
    @@ -716,9 +716,8 @@
    ]
    },
    {
    "filename": "**/specification/servicebus/resource-manager/Microsoft.ServiceBus/preview/2018-01-01-preview/servicebus-preview.json",
    "filename": "**/specification/servicebus/resource-manager/Microsoft.ServiceBus/preview/2018-01-01-preview/NetworkRuleSet-preview.json",
    Copy link
    Member

    Choose a reason for hiding this comment

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

    This file doesn't exist in master branch.

    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    Right, looks like it got renamed again in #11743

    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    Looks like this is fixed now, so I removed it and added some related missing file-specific overrides that had gotten added to the root dictionary

    Copy link
    Contributor Author

    @nschonni nschonni Jan 25, 2021

    Choose a reason for hiding this comment

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

    Did a little test script and cleaned out some other renamed files

    const fs = require('fs');
    
    const cspell = JSON.parse(fs.readFileSync('cSpell.json', 'utf-8'));
    
    cspell.overrides.forEach(element => {
        let filename = element.filename.substring(3);
    
        try {
            let content = fs.readFileSync(filename, 'utf-8')
            element.words.forEach(word => {
                if (content.indexOf(word) === -1) {
                    console.warn(`BAD: ${filename}\n${word}`)
                }
            })
        } catch (error) {
            console.warn(`BAD: ${filename}\n${error}`)
        }
    });

    @nschonni nschonni force-pushed the renamed-ignored-cspell branch 4 times, most recently from 6d131c9 to 30e3afa Compare January 25, 2021 07:56
    @nschonni nschonni requested a review from raych1 January 25, 2021 07:58
    @nschonni nschonni force-pushed the renamed-ignored-cspell branch 3 times, most recently from 8ad6f85 to 814bc66 Compare January 25, 2021 08:50
    @nschonni nschonni mentioned this pull request Jan 25, 2021
    25 tasks
    @nschonni nschonni force-pushed the renamed-ignored-cspell branch from 814bc66 to 0798e92 Compare January 25, 2021 08:55
    @nschonni nschonni changed the title fix: Renamed spec files in cSpell ignores fix: Renamed spec files and unneeded cSpell ignores Jan 25, 2021
    @nschonni nschonni changed the title fix: Renamed spec files and unneeded cSpell ignores fix: Renamed spec files and incorrect cSpell ignores Jan 25, 2021
    @nschonni nschonni force-pushed the renamed-ignored-cspell branch from 0798e92 to 222e5ea Compare January 26, 2021 00:47
    @nschonni
    Copy link
    Contributor Author

    @raych1 added another missing "Regenerte" for the current failure on the main branch https://github.com/Azure/azure-rest-api-specs/runs/1765899989

    @nschonni nschonni force-pushed the renamed-ignored-cspell branch 4 times, most recently from 40036d8 to 771fe35 Compare January 30, 2021 07:05
    @nschonni nschonni force-pushed the renamed-ignored-cspell branch from 771fe35 to 0bc0769 Compare February 4, 2021 04:31
    @ghost
    Copy link

    ghost commented Feb 21, 2021

    Hi, @nschonni. Your PR has no update for 14 days and it is marked as stale PR. If no further update for over 14 days, the bot will close the PR. If you want to refresh the PR, please remove no-recent-activity label.

    @ghost ghost added the no-recent-activity label Feb 21, 2021
    @nschonni nschonni force-pushed the renamed-ignored-cspell branch from 0bc0769 to 69889bf Compare February 21, 2021 16:58
    privatepreview
    projectable
    propogation
    Protectable
    ProviderHub
    Providerhub
    Copy link
    Member

    Choose a reason for hiding this comment

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

    Why changed the case?

    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    It had been added with both casings. CamelCase is already treated as separate words by cSpell

    @@ -1518,7 +1530,6 @@ RSNULL
    rstrnt
    RTMP
    RTSP
    Ruleproperties
    Copy link
    Member

    Choose a reason for hiding this comment

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

    How about this removing?

    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    Moved to a file level suppression again

    @@ -1589,7 +1600,6 @@ sessionids
    sessionstate
    SETACL
    SETEXPIRY
    Setget
    setissuers
    SETOWNER
    Copy link
    Member

    Choose a reason for hiding this comment

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

    Same here?

    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    File level suppression

    @@ -1971,7 +1982,6 @@ vmimage
    vmname
    vmotion
    VMQS
    vmsizes
    Copy link
    Member

    Choose a reason for hiding this comment

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

    Same here?

    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    File level suppression

    @@ -2070,29 +2080,3 @@ ziplist
    Zoho
    zoneinfo
    zset
    tpgs
    Copy link
    Member

    Choose a reason for hiding this comment

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

    I don't see these words in this file any more. Why do we remove them?

    tpgs
    ProviderHub
    regionality
    Resource
    metdata
    Exprired
    saskey
    vmsize
    FSLogix
    
    

    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    Some were unfixed typos moved to file level suppression in cspell.json, duplicates of words that were already in the file in the right sort location, CamelCase words, that cSpell already treats as separate words, or correctly spelled words like "Resource" that shouldn't be in this overrides dictionary

    @@ -333,6 +255,12 @@
    "Regenerte"
    ]
    },
    {
    "filename": "**/specification/keyvault/data-plane/Microsoft.KeyVault/stable/7.1/storage.json",
    Copy link
    Member

    Choose a reason for hiding this comment

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

    Can you add for other keyvault versions too?

    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    These were the only ones with the issue

    Copy link
    Member

    @raych1 raych1 left a comment

    Choose a reason for hiding this comment

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

    @nschonni , sorry for the late reply. Can you have a look at my comments?

    @raych1 raych1 added the Reviewed-ChangesRequested <valid label in PR review process>add this label when assignee request changes after review label Mar 1, 2021
    @nschonni nschonni requested a review from raych1 March 1, 2021 02:38
    @nschonni nschonni force-pushed the renamed-ignored-cspell branch from 69889bf to 4b4c04b Compare March 1, 2021 02:43
    @@ -304,9 +309,11 @@ changedSince
    changepoint
    changestate
    CHECKACCESS
    Checkfeature
    CheckfeatureSupport
    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    I don't think this one is needed since "Checkfeature" is already in, and "Support" would be treated as a separate word because it is camelCase.
    It's possible "Checkfeature" should be moved to a file level suppression and fixed in the spec though

    Copy link
    Member

    Choose a reason for hiding this comment

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

    Thanks @nschonni for the reply. Can you run the spell check locally for all the specs and check the result?

    Copy link
    Contributor Author

    Choose a reason for hiding this comment

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

    I did that over in #11474, but due to the size I don't think it's going to land till smaller pieces can be landed to shrink it

    @raych1
    Copy link
    Member

    raych1 commented Mar 15, 2021

    @nschonni , could you please resolve the conflicts so that I can merge this PR? Thanks.

    @nschonni nschonni force-pushed the renamed-ignored-cspell branch from 4b4c04b to 3e6001d Compare March 15, 2021 02:39
    @nschonni nschonni marked this pull request as draft March 15, 2021 02:51
    @nschonni nschonni force-pushed the renamed-ignored-cspell branch from 3e6001d to a308d12 Compare March 15, 2021 03:11
    @nschonni nschonni marked this pull request as ready for review March 15, 2021 03:12
    @nschonni
    Copy link
    Contributor Author

    nschonni commented Mar 15, 2021

    @raych1 I've rebased this one. After #12638 and #12638 land, cSpell can be update to v5 with a full clean run, and the runtime across the full repo drops from 16 minutes to 3 😄

    @raych1
    Copy link
    Member

    raych1 commented Mar 15, 2021

    @nschonni , can you resolve the conflicts again? Thanks.

    @nschonni nschonni force-pushed the renamed-ignored-cspell branch from a308d12 to 9ebbef1 Compare March 15, 2021 14:57
    @nschonni
    Copy link
    Contributor Author

    @raych1 rebased again

    @raych1
    Copy link
    Member

    raych1 commented Mar 16, 2021

    /azp run

    @azure-pipelines
    Copy link

    Azure Pipelines successfully started running 2 pipeline(s).

    @raych1 raych1 removed the Reviewed-ChangesRequested <valid label in PR review process>add this label when assignee request changes after review label Mar 16, 2021
    @raych1 raych1 merged commit ada21ec into Azure:master Mar 16, 2021
    @nschonni nschonni deleted the renamed-ignored-cspell branch March 16, 2021 01:00
    MirzaSikander pushed a commit to MirzaSikander/azure-rest-api-specs that referenced this pull request Mar 22, 2021
    mkarmark pushed a commit to mkarmark/azure-rest-api-specs that referenced this pull request Jul 21, 2021
    Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
    Labels
    customer-reported Issues that are reported by GitHub users external to the Azure organization.
    Projects
    None yet
    Development

    Successfully merging this pull request may close these issues.

    2 participants