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

AURO MIGRATION: Update Templates to v2 #33

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

chrisfalaska
Copy link
Collaborator

@chrisfalaska chrisfalaska commented Feb 5, 2025

Resolves #30

Summary by Sourcery

Update issue templates to YAML format and add new templates for general support, stories, tasks, and groups. Update the settings YAML file and remove the old markdown templates. Update node version to 20 and 22 for testing and publishing, and update the codeql workflow to use javascript. Update the contributing guidelines with more information about submitting issues and pull requests, including a section on rebasing. Update the code of conduct and security policy. Update the pull request template and add a codeowners file. Add a new workflow to publish a demo on pull requests to the main branch.

New Features:

  • Add new issue templates for general support, stories, tasks, and groups.

CI:

  • Update the CodeQL workflow to use JavaScript and update Node.js versions to 20 and 22 for testing and publishing.

Documentation:

  • Update contributing guidelines with information about submitting issues and pull requests, rebasing, and conventional commits. Update the code of conduct and security policy.

@chrisfalaska chrisfalaska requested a review from a team as a code owner February 5, 2025 23:31
@chrisfalaska chrisfalaska self-assigned this Feb 5, 2025
Copy link

sourcery-ai bot commented Feb 5, 2025

Reviewer's Guide by Sourcery

This pull request updates the templates and configurations for the Auro Design System, focusing on improving contribution guidelines, issue reporting, and workflow processes. It also updates the testing and publishing workflows to include Node.js versions 20 and 22.

State diagram: Updated issue lifecycle

stateDiagram-v2
    [*] --> Submitted
    Submitted --> UnderReview: Team reviews within 48h
    UnderReview --> Approved: Team approves
    UnderReview --> Closed: Team rejects
    Approved --> InProgress: Work starts
    InProgress --> Abandoned: No activity for 30 days
    InProgress --> Completed: Work finished
    Abandoned --> [*]
    Completed --> [*]
    Closed --> [*]
Loading

Flow diagram: Updated PR contribution process

graph TD
    A[Submit Issue] -->|Wait 48h max| B[Team Review]
    B --> C{Issue Approved?}
    C -->|Yes| D[Start Work]
    C -->|No| E[Issue Closed]
    D --> F[Create Feature Branch]
    F --> G[Make Changes]
    G --> H[Commit with Convention]
    H --> I[Rebase on Main]
    I --> J[Push Changes]
    J --> K[Create PR]
    K --> L[Team Review]
    L --> M{PR Approved?}
    M -->|Yes| N[Merge to Main]
    M -->|No| O[Address Feedback]
    O --> L
Loading

File-Level Changes

Change Details Files
Updated contributing guidelines to include innersourcing flow guide, more details on feature requests, and pull request submission.
  • Added a link to the Innersourcing Flow Guide on Sharepoint for Alaska Airlines employees.
  • Clarified the process for feature requests and issue reporting.
  • Emphasized the importance of consulting with the Auro team before starting work on a pull request.
  • Added details on feature branch naming conventions.
  • Discouraged using git pull on feature branches and provided instructions for rebasing.
  • Reinforced the use of Conventional Commits and provided examples.
  • Updated the pull request service level agreement.
  • Added a section for pull request service level agreement.
.github/CONTRIBUTING.md
Updated issue templates to clarify content and improve the bug reporting process.
  • Replaced the old issue templates with new YAML-based templates for bug reports, feature requests, and general support.
  • Added templates for stories, tasks, and groups to better categorize issues.
  • Improved the structure and content of the bug report template to gather more specific information.
  • Added exit criteria section to all issue templates.
.github/ISSUE_TEMPLATE/bug_report.yaml
.github/ISSUE_TEMPLATE/feature_request.yaml
.github/ISSUE_TEMPLATE/general-support.yaml
.github/ISSUE_TEMPLATE/story.yaml
.github/ISSUE_TEMPLATE/task.yaml
.github/ISSUE_TEMPLATE/group.yaml
Updated the CodeQL workflow to specify the JavaScript language and use actions/[email protected] and github/codeql-action/analyze@v3.
  • Updated the actions/checkout version to v4.1.1.
  • Updated the github/codeql-action/analyze version to v3.
  • Explicitly specified 'javascript' as the language for CodeQL analysis.
.github/workflows/codeql.yml
Updated the test and publish workflow to include Node.js versions 20 and 22 and adjusted the build command for release.
  • Modified the node-version matrix to include 20 and 22.
  • Changed the build command for the release job to npm run build:release.
  • Added beta branch to the trigger events.
.github/workflows/testPublish.yml
Removed deprecated workflows and issue templates.
  • Removed the addToProject.yml, autoAssign.yml, and duplicate-issue.yml workflows.
  • Removed the old markdown-based issue templates.
.github/workflows/addToProject.yml
.github/workflows/autoAssign.yml
.github/workflows/duplicate-issue.yml
.github/ISSUE_TEMPLATE/bug_report.md
.github/ISSUE_TEMPLATE/feature_request.md
.github/ISSUE_TEMPLATE/general-support.md
Added a security policy to describe how to report security issues.
  • Created a SECURITY.md file with guidelines for reporting security vulnerabilities.
  • Provided instructions for reporting security issues through Alaska Airlines' portal.
  • Included a link to GitHub's Safe Harbor Policy.
.github/SECURITY.md
Updated repository settings to align with current standards.
  • Updated the repository topics.
  • Updated the test contexts for branch protection rules.
  • Removed label definitions.
.github/settings.yml

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!
  • Generate a plan of action for an issue: Comment @sourcery-ai plan on
    an issue to generate a plan of action for it.

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

Copy link

github-actions bot commented Feb 5, 2025

Surge demo deployment failed! 😭

Copy link

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

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

Hey @chrisfalaska - I've reviewed your changes - here's some feedback:

Overall Comments:

  • The PR replaces older MD issue templates with YAML versions. Please double-check that any external documentation or integrations referencing the old .md templates are updated accordingly to avoid contributor confusion.
  • In the workflows (e.g., testPublish.yml and codeql.yml), node versions and branch triggers were updated. Confirm that these new settings (node 20/22, and including beta branch) match your intended release and testing strategies.
Here's what I looked at during the review
  • 🟡 General issues: 2 issues found
  • 🟢 Security: all looks good
  • 🟢 Testing: all looks good
  • 🟢 Complexity: all looks good
  • 🟢 Documentation: all looks good

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Comment on lines +65 to +68
$ git checkout main
$ git pull
$ git checkout [feature branch]
$ git rebase main
Copy link

Choose a reason for hiding this comment

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

suggestion (bug_risk): Cautionary note about force pushing.

Force pushing can rewrite history and should be used with caution. It's important to understand the risks before using it.

Suggested change
$ git checkout main
$ git pull
$ git checkout [feature branch]
$ git rebase main
$ git checkout main
$ git pull
$ git checkout [feature branch]
$ git rebase main
> **⚠️ Warning:** If you need to force push after rebasing (`git push --force`), use it with extreme caution. Force pushing rewrites the branch's history and can cause problems for other developers who have based their work on the previous branch state. Consider using `git push --force-with-lease` instead, which is safer as it prevents accidentally overwriting others' work.

## Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [email protected]. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
Copy link

Choose a reason for hiding this comment

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

suggestion: Consider replacing the specific email address with a more general contact method.

Using a generic contact like a dedicated email address for reporting such issues or a web form might be more maintainable in the long run.

Suggested implementation:

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening a confidential issue at https://github.com/AlaskaAirlines/[repo-name]/issues/new/choose or by emailing [email protected]. All complaints will be reviewed and investigated

Note: The specific contact method (URL and email) should be adjusted based on:

  1. The actual repository name in place of [repo-name]
  2. The preferred contact email address for your organization
  3. Whether you want to use a different reporting mechanism like a web form or alternative contact method

Please adjust these placeholders according to your organization's preferred reporting channels.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Migrate all .github config files from template into each repository
1 participant