Skip to content

Conversation

@laurenic0l
Copy link
Contributor

first draft of component fundamentals article

- refactored fundamentals article to focus on foundational architectural
concepts, removing decision-making content that will move to a separate
Building Components Guide article
@laurenic0l laurenic0l marked this pull request as ready for review December 9, 2025 14:28
@laurenic0l laurenic0l added the status: waiting-for-review The PR is ready. Waiting for team members to review. label Dec 9, 2025
Copy link
Member

@hyyan hyyan left a comment

Choose a reason for hiding this comment

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

Great article! The content is well-written.

A few suggestions:

  • Consider adding a mention of ComponentLifecycleObserver since it's related content readers might find useful.

  • The article covers some advanced concepts (component identity, PropertyDescriptors, ElementCompositeContainer). To make the learning path smoother for beginners, consider splitting into sub-pages - keep fundamentals simple (Composite basics, lifecycle, concern interfaces) and move advanced topics to separate pages.

See inline comments for other suggestions.

@hyyan hyyan added status: waiting-for-author Review is done. Waiting for the PR author to apply changes or respond. and removed status: waiting-for-review The PR is ready. Waiting for team members to review. labels Dec 10, 2025
Strip Component Fundamentals to core architectural concepts, removing
advanced topics and detailed code examples that will be covered in
separate articles
@laurenic0l laurenic0l added status: waiting-for-review The PR is ready. Waiting for team members to review. status: waiting-for-author Review is done. Waiting for the PR author to apply changes or respond. and removed status: waiting-for-author Review is done. Waiting for the PR author to apply changes or respond. status: waiting-for-review The PR is ready. Waiting for team members to review. labels Dec 15, 2025
@laurenic0l laurenic0l added status: waiting-for-review The PR is ready. Waiting for team members to review. and removed status: waiting-for-author Review is done. Waiting for the PR author to apply changes or respond. labels Dec 17, 2025
@laurenic0l
Copy link
Contributor Author

Simplified the article to keep it beginner-friendly and ensured no duplicate information.

The article now focuses on the foundational concepts - component hierarchy, basic lifecycle overview, and concern interfaces. I removed the more detailed/advanced topics like component identity implementation details, detailed lifecycle code examples, and ComponentLifecycleObserver.

These will be covered in other articles during the Building UI restructure. Detailed lifecycle implementation will go in the using-components.md article, component identity usage will be in building-components-guide.md, etc.

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

Labels

status: waiting-for-review The PR is ready. Waiting for team members to review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants