Skip to content

Commit

Permalink
Updates based on feedback
Browse files Browse the repository at this point in the history
  • Loading branch information
jcalcaben committed Oct 11, 2019
1 parent 125207a commit cce0000
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions pwa-devdocs/_drafts/talons/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Most [React component][] contain two distinct sections: a section for logic and
The logic section contains code for generating new values from props, maintaining local state, and lifecycle or side effect methods.
This section can be considered the "brains" of the component.

The presentational section of a React component contains code that defines the component's DOM structure.
The content section of a React component contains code that defines the component's DOM structure.
It often uses values from the logic part of the component to pass down into another component or display using HTML elements.

PWA Studio separates these two sections into distinct components with specific concerns: a Venia UI component and a Peregrine Talon.
Expand All @@ -27,8 +27,8 @@ The `useSearchBar()` talon also keeps track of the component's `expanded` state,
Talons are a PWA Studio concept that represent a specialized type of React hook.

Peregrine **hooks**, such as `useDropdown()` and `useWindowSize()`, are designed to be re-usable pieces of code, but
Peregrine **talons** are designed to fulfill the logic needs of a single Venia UI component.
This means that each talon belongs to a specific UI component in Venia and is not used in any other Venia component.
Peregrine **talons** are designed to fulfill the logic needs of individual Venia UI components.
This means that each talon corresponds to a single Venia component and is not useful outside the component.
If a talon needs to use functionality identical to another talon, it is provided by a Peregrine hook.

For example, the functionality provided by the `useHeader()` talon is only relevant to the the `Header` component.
Expand Down

0 comments on commit cce0000

Please # to comment.