Create a Roll Out Plan for adding Code Spell Checker VS Code Extension

[jdingeman]

Dependency

• VS Code Spell Checker Extension: GHA Messaging #4469
• VS Code Spell Checker Extension: Meeting Messaging #4470
• Decision Record: VS Code Spell Checker Extension #4471
• Epic: Create template, spreadsheet and list of issues for spellcheck audit #5248
• Epic: Create issues to add false positives to cspell.json #5312
• Create initial spell check configuration file #5313
• Epic: Create issues to add ignorePaths to cSpell configuration file #5450
• add instructions for workstation spell checking using npm package #5652
• Create issue template "Resolve Spell Check warning" #6446

Overview

We need to create a roll out plan for having all HfLA website developers install the Code Spell Checker VS Code extension so that we can reduce confusion for our dev team when using in their local development environment, during PRs, and while reviewing PRs.

Action Items

• Draft a Plan Overview
• Decide if feature branches are necessary
• Review with Merge Team
• Create issues for each of the items that need it
  • Add them to the Dependencies section of this issue
• Once all components (dependency issues) of the plan are drafted (not yet completed)
  • Identify what can be done now, and what has to wait until a specific trigger
  • TBD...

Resources/Instructions

• Add Code Spell Checker VS Code extension installation instructions #4101
• Decision Records
• Code Spell Checker

[jdingeman]

@ExperimentsInHonesty - I know the Wiki is on a pause right now but my thought was that the Wiki would likely be migrated to Mkdocs before this gets implemented, but please let me know if we should go with an alternative, like Google Docs.

[ExperimentsInHonesty]

Plan Overview

Instructions

Requirements

• Clear wording
• Links to relevant files
• Screenshots when required

What to cover

• How to install locally
• How to increase the scope of your issue if the local linter finds problems (what to note in the issue and pr)
• What do we expect will happen when you do a PR and what to do about it
  • if you don't catch all the problems, the linter will find locally
  • if you do catch all the problems, the linter will find locally
  • if the repo linter finds other problems the local linter did not (we hope it won't but...)
• PR reviewers: How to handle scope changes, caused by the local linter, in the PR you are reviewing

Where to message

Contributing.md

Wiki

• DR
• Other?

Prework template

• for new preworks

Slack

• Which channels

GHAs

• GHA messages on PRs
• GHA messages on existing issues
  • size of issue:
    • prework
    • ?

In Meetings

• HfLA onboarding
• Dev meetings (Tues, Thurs, Sun)

Actions & Timelines

You don't have to answer When? until all the messages are ready

Publish Instructions

Where

• Contributing file Add Code Spell Checker VS Code extension installation instructions #4101
• GHAs
• Slides

When?

Direct Developers to install the VS Code plugin during dev environment setup

Who:

• Existing developers
• New developers

When?

Install Linter on GitHub repo

When?

[ExperimentsInHonesty]

Draft ISSUE

Title: Spell Linter: GHA Messaging

Overview

Review the GHAs, identify what messaging will support the rollout plan, and draft messages.

Action Items

• Familiarize yourself with our existing GitHub Actions
  • Identify if any of them should be temporarily edited to include messages to developers about the new implementation
    • Add list to a comment, with general instructions on what might be included per GHA
    • Add any additional GHAs you think we could write that would post something on an issue or PR that would be helpful.
• Present your documentation (a comment with the details of where and what) to the Product and Dev Lead team and refine plan as needed
• Create issues to make the changes (one per GHA).
  • Add this issue as a Dependency to the new issues

Potential Scenarios

• A GitHub Action that leaves a comment when developers assign themselves to issues
  • The message serves as a reminder that we are implementing a new VS Code extension
  • The message should include a checkbox for the dev to acknowledge that they've read and understand the instructions and changes to the contributing.md
• A GitHub Action that leaves a comment on new prework issues
  • The message serves as a reminder for the new dev that we are implementing a new VS Code extension
  • The message should include a checkbox for the dev to acknowledge that they've read and understand the instructions and changes to the contributing.md
  • A GitHub Action that leaves a comment on newly created pull requests
    • This message will notify pull request reviewers that any changes in a developer's pull request (specifically spelling corrections) will be considered within the scope of their issue, since they can make the changes in a file containing spelling errors
    • e.g.

      We added a spelling linter on X date,
      If the PR contains spelling changes, those are included in the scope of this issue.
      if the PR has not passed the linter because spelling changes are suggested, please see the contributing X section for installing the VS code plugin.

For PM, Tech Lead, Merge Team

• When the GHA Messaging plan is accepted, review the changes and determine how they will be implemented (feature branch, etc.)
• release dependency on Create a Roll Out Plan for adding Code Spell Checker VS Code Extension #4349 and move that issue into the New Issue Approval column with the ready for dev lead or ready for product label for review and a note about where to find the finished plan.

Resources

• WIKI page with GHAs

[github-actions]

Hi @ExperimentsInHonesty, thank you for taking up this issue! Hfla appreciates you :)

Do let fellow developers know about your:-
i. Availability: (When are you available to work on the issue/answer questions other programmers might have about your issue?)
ii. ETA: (When do you expect this issue to be completed?)

You're awesome!

P.S. - You may not take up another issue until this issue gets merged (or closed). Thanks again :)