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

Implement changes to formkit README doc structure #203

Merged
merged 2 commits into from
Jan 14, 2025

Conversation

jordanjones243
Copy link
Contributor

@jordanjones243 jordanjones243 commented Jan 13, 2025

Alaska Airlines Pull Request

Before Submitting this pull request:

  • Link all tickets in this repository related to this PR in the Development section
    note: all pull requests require at least one linked ticket
  • If this PR is Ready For Review, all ticket's linked under Development must have their status changed to Ready For Review as well

By submitting this Pull Request, I confirm that my contribution is made under the terms of the Apache 2.0 license and I have performed a self-review of my own update.

Summary by Sourcery

Update README files for all components to use a shared template and remove outdated content.

Enhancements:

  • Removed outdated content, such as specific installation instructions and API examples, from the component README files.
  • Updated package names and versions in the README files.
  • Improved the structure and consistency of the README files across all components.

Documentation:

  • Updated README files for all components to use a shared template.

@jordanjones243 jordanjones243 self-assigned this Jan 13, 2025
@jordanjones243 jordanjones243 requested a review from a team as a code owner January 13, 2025 20:36
Copy link

sourcery-ai bot commented Jan 13, 2025

Reviewer's Guide by Sourcery

This PR implements changes to the formkit README doc structure by updating the paths for the template files used to generate the documentation. It also updates the component names and installation instructions to reflect the new monorepo structure.

Class diagram showing the updated package structure

classDiagram
    class AuroFormkit {
        +version: string
        +monorepoName: string
    }

    AuroFormkit --> Checkbox
    AuroFormkit --> Combobox
    AuroFormkit --> Counter
    AuroFormkit --> Datepicker
    AuroFormkit --> Dropdown
    AuroFormkit --> Form
    AuroFormkit --> Input
    AuroFormkit --> Menu
    AuroFormkit --> Radio
    AuroFormkit --> Select

    class Combobox {
        +dependencies: [Dropdown, Input, Menu]
    }

    class Datepicker {
        +dependencies: [Dropdown, Input, Popover]
    }

    class Select {
        +dependencies: [Dropdown, Menu]
    }

    note for AuroFormkit "Package renamed from @auro-formkit to @aurodesignsystem"
Loading

File-Level Changes

Change Details Files
Updated the template file path for generating README files.
  • Changed the template file path from https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/README_updated_paths.md to ../../docs/templates/componentReadmeTemplate.md.
components/select/README.md
components/combobox/README.md
components/datepicker/README.md
components/checkbox/README.md
components/dropdown/README.md
components/form/README.md
components/input/README.md
components/menu/README.md
components/radio/README.md
Updated component titles to remove "Formkit/" prefix.
  • Removed "Formkit/" prefix from component titles.
components/select/README.md
components/combobox/README.md
components/datepicker/README.md
components/checkbox/README.md
components/dropdown/README.md
components/form/README.md
components/input/README.md
components/menu/README.md
components/radio/README.md
Updated component descriptions and installation instructions.
  • Condensed redundant information in the select component description.
  • Removed installation instructions for individual components.
  • Updated installation instructions to use @aurodesignsystem npm scope.
components/select/README.md
components/select/docs/partials/description.md
components/combobox/README.md
components/datepicker/README.md
components/checkbox/README.md
components/dropdown/README.md
components/form/README.md
components/input/README.md
components/menu/README.md
components/radio/README.md
Updated the build process for generating documentation.
  • Added new template files for component installation, usage, and bundled assets.
  • Updated the docProcessor to use the new template files.
  • Updated package dependencies.
  • Updated component package names.
packages/build-tools/src/docProcessor.mjs
package.json
README.md
docs/partials/description.md
docs/templates/componentReadmeTemplate.md
docs/templates/componentBundleUseModBrowsers.md
docs/templates/componentInstall.md
docs/templates/componentUsage.md
components/combobox/package.json
components/checkbox/package.json
components/counter/package.json
components/datepicker/package.json
components/dropdown/package.json
components/form/package.json
components/input/package.json
components/menu/package.json
components/radio/package.json
components/select/package.json
package-lock.json

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.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a 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. You can also use
    this command to specify where the summary should be inserted.

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

@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 @jordanjones243 - I've reviewed your changes - here's some feedback:

Overall Comments:

  • Consider adding migration documentation to help users transition from @auro-formkit/* packages to the new @aurodesignsystem/auro-formkit/* package structure.
Here's what I looked at during the review
  • 🟡 General issues: 3 issues found
  • 🟢 Security: all looks good
  • 🟢 Testing: all looks good
  • 🟡 Complexity: 1 issue found
  • 🟢 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.

packages/build-tools/src/docProcessor.mjs Show resolved Hide resolved
packages/build-tools/src/docProcessor.mjs Show resolved Hide resolved
components/select/README.md Outdated Show resolved Hide resolved
packages/build-tools/src/docProcessor.mjs Show resolved Hide resolved
@jordanjones243 jordanjones243 force-pushed the jjones/readMeAndDocs branch 2 times, most recently from 55e8a8a to 3421dfe Compare January 13, 2025 20:40
Copy link
Contributor

@rmenner rmenner left a comment

Choose a reason for hiding this comment

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

Ran it locally. Could not find anything else wrong. Looking great except for that one issue.

@jordanjones243 jordanjones243 merged commit 03d0c1b into beta Jan 14, 2025
4 checks passed
@jordanjones243 jordanjones243 deleted the jjones/readMeAndDocs branch January 14, 2025 17:50
@jason-capsule42
Copy link
Member

🎉 This PR is included in version 2.0.0-beta.6 🎉

The release is available on:

Your semantic-release bot 📦🚀

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

Successfully merging this pull request may close these issues.

auro-formkit Installation documentation shows wrong NPM path to install
3 participants