Conceptual guides and component architecture fix#2041
Open
Manik-Khajuria-5 wants to merge 5 commits intoplone:6.0from
Open
Conceptual guides and component architecture fix#2041Manik-Khajuria-5 wants to merge 5 commits intoplone:6.0from
Manik-Khajuria-5 wants to merge 5 commits intoplone:6.0from
Conversation
davisagli
reviewed
Feb 12, 2026
Member
davisagli
left a comment
davisagli
left a comment
There was a problem hiding this comment.
This looks to be off to a good start to me.
docs/conceptual-guides/components.md
Outdated
| @@ -167,40 +167,174 @@ A global utility is constructed when Plone is started and ZCML is read. (needs V | |||
| A local component is either a persistent object in the ZODB or constructed when (TODO: When? Traversal time? Lookup time?) | |||
| ``` | |||
Member
There was a problem hiding this comment.
Convert the above todo into a normal paragraph:
A global utility is constructed when Plone is started and ZCML is loaded.
A local component is stored as a persistent object in the ZODB.
Contributor
Author
There was a problem hiding this comment.
okk got it
Contributor
Author
|
@davisagli Thanks for review working on mentioned changes |
- Split long sentences into individual lines throughout components.md - Fix Concepts section (Interface, Adapter, Events, Registries, Lookup) - Ensure all paragraphs follow one-sentence-per-line style guide - Resolves formatting issues where text appeared as paragraphs instead of lines
Manik-Khajuria-5
force-pushed
the
Conceptual-guides-and-Component-architecture-fix
branch
from
62004e5 to
d5ed69d
Compare
Contributor
Author
|
@davisagli I have made required changes |
davisagli
reviewed
Feb 18, 2026
Member
davisagli
left a comment
davisagli
left a comment
There was a problem hiding this comment.
@stevepiercy I think the information here is accurate.
Contributor
Author
|
@davisagli I have applied the mentioned changes |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issue number
Description
This pull request improves the Plone Components documentation by clarifying and updating sections related to utilities, adapters, and event subscribers.
The changes focus on making the component architecture easier to understand by:
Explaining how utilities are registered and looked up
Improving adapter registration and usage examples
Updating events and subscribers references
Removing or correcting outdated or unclear documentation links
📚 Documentation preview 📚: https://plone6--2041.org.readthedocs.build/