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

Component System: Continue Integration #28399

Closed
27 of 32 tasks
ItsJonQ opened this issue Jan 21, 2021 · 6 comments
Closed
27 of 32 tasks

Component System: Continue Integration #28399

ItsJonQ opened this issue Jan 21, 2021 · 6 comments
Assignees
Labels
[Feature] Component System WordPress component system [Focus] Accessibility (a11y) Changes that impact accessibility and need corresponding review (e.g. markup changes). [Package] Components /packages/components [Status] In Progress Tracking issues with work in progress [Type] Tracking Issue Tactical breakdown of efforts across the codebase and/or tied to Overview issues.

Comments

@ItsJonQ
Copy link

ItsJonQ commented Jan 21, 2021

This is an extension of Implementing a Component System


Context ✨

The FontSizePicker component was first to receive the upgrade to use the new Components System.

We opted for a strategy (proposed by @gziolo) that imports and uses the various system parts via npm dependencies, rather than migrating the code by copying/pasting them over.

This was largely to expedite us figuring out the process for integration.
Using the new Component System code via external packages is not the end goal.


Back Filling 🔙

@gziolo has identified the component dependencies of FontSizePicker in a comment.

We're in a place where we can work on "back filling" these components so that

  • FontSizePicker would no longer depend on external component dependencies
  • We'll establish the new foundation for the Component System

Components List 📦

Below is the list of components we'll need to integrate into @wordpress/components from the new component system library.

These have been ranked in dependency order, as well as complexity:

I've added this to the running G2 Components integration spreadsheet to help track the progress:
https://docs.google.com/spreadsheets/d/1gfzznyJtTr3hHoGkGRdeBRjhuZVMRalF9NuLrxkl4Nk/edit?usp=sharing

To get a visual sense of how these components are composed together, you can check out this visual flow map:
https://miro.com/app/board/o9J_khVkF9A=/?moveToWidget=3074457351837142359&cot=14


Contribution 🙏

Help in this effort is definitely welcome!

I recognize that there's a lot that goes into the new Component System.

I've recorded a walkthrough of it on the project blog:
https://g2components.wordpress.com/2020/12/02/walkthrough-integration-ideas/

If you're interested in helping and you're having trouble navigating the space, please let me know!
I'd be happy to help however I can.

I recorded a walkthrough tutorial on how we're moving these components (note: some of the things may be outdated. I'll need to re-record this, but it may help as a starting point)
https://g2components.wordpress.com/2021/01/27/moving-components-to-gutenberg-walkthrough/

@ItsJonQ ItsJonQ added the [Feature] Component System WordPress component system label Jan 21, 2021
@ItsJonQ ItsJonQ self-assigned this Jan 21, 2021
@ItsJonQ ItsJonQ changed the title Component System: Continue Component Integration Component System: Continue Integration Jan 21, 2021
@gziolo gziolo added [Type] Tracking Issue Tactical breakdown of efforts across the codebase and/or tied to Overview issues. [Package] Components /packages/components [Status] In Progress Tracking issues with work in progress Good First Issue An issue that's suitable for someone looking to contribute for the first time labels Jan 23, 2021
@gziolo gziolo added the [Focus] Accessibility (a11y) Changes that impact accessibility and need corresponding review (e.g. markup changes). label Feb 1, 2021
@gziolo
Copy link
Member

gziolo commented Feb 2, 2021

I'm copying over some issues I raised while working on #28624::

  • FontSizeControl isn't typed and therefore it can't be included in the export in packages/components/src/ui/index.js
  • FontSizeControl and View don't have stories
  • FonteSizeControl and View don't have unit tests
  • All React hooks included for G2 components aren't covered with unit tests
    • useFontSizeControl
    • useGrid
    • useText
    • useTruncate
    • useView
  • It would be great to cover general-purpose utils (createComponents, getOptimalTextShade) with unit tests
  • Should individual utils be covered with unit tests as well?

I also opened #28661 that proposes the removal of the temporary feature flag that excludes G2 components codebase from the upcoming WordPress release.

@ItsJonQ
Copy link
Author

ItsJonQ commented Feb 4, 2021

@gziolo +100 on concerns for testing. We need to go back to add tests for these component hooks 👍 (as well as new things coming into Gutenberg)

@sarayourfriend
Copy link
Contributor

Added several missing components from here that are dependencies of FontSizeControl, this list keeps growing 😱

@ItsJonQ
Copy link
Author

ItsJonQ commented Feb 16, 2021

Alrighty! We have another batch of updates ready for merge (thanks a bunch @sarayourfriend !)

I think they should be merged in that order.
Although they don't depend on each other, I think it'll make it easier (from a package.json/package-lock.json perspective).


According to the status site, we're currently at ~16% integrated.

Screen Shot 2021-02-16 at 4 00 01 PM

This is great!

@sarayourfriend
Copy link
Contributor

Removing the Good First Issue label because this is no longer a good first issue as demonstrated by @ramonjd and @ntsekouras's attempts to integrate some components.

@sarayourfriend
Copy link
Contributor

Closing this issue in favor of the bigger tracking issue at #30503

All the remaining components from this issue have been moved over to that tracking issue under the "Finish the FontSizePicker integration" heading

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Feature] Component System WordPress component system [Focus] Accessibility (a11y) Changes that impact accessibility and need corresponding review (e.g. markup changes). [Package] Components /packages/components [Status] In Progress Tracking issues with work in progress [Type] Tracking Issue Tactical breakdown of efforts across the codebase and/or tied to Overview issues.
Projects
None yet
Development

No branches or pull requests

3 participants