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

Merge release 3.1.1 into 3.2.x #31

Merged

Conversation

github-actions[bot]
Copy link

@github-actions github-actions bot commented Oct 6, 2020

Release Notes for 3.1.1

3.1.1

  • Total issues resolved: 0
  • Total pull requests resolved: 3
  • Total contributors: 3

Documentation

Documentation,Enhancement,Review Needed

Bug,Documentation

michalbundyra and others added 16 commits July 20, 2020 14:22
Correction according to method definition
The intent here isn't to make this in to a marketing piece, rather to
provide a succinct, yet also sufficiently descriptive snapshot
overview/introduction to what laminas-hydrator is. It's aimed at people
who are seeing the package/component for the first time and need to
quickly know what it is. I hope that this change does that, and gives
them incentive to delve deeper.

Signed-off-by: Matthew Setter <[email protected]>
The intent of this change is to make the content far more accessible to
first time readers. The changes include:

1. Update the introductory content to build upon the core description in
index.md. This time, the user is a step deeper, and seeking to learn
more. So this description takes them that bit deeper, providing them
quick and easy access to the next level down in to the component.
2. As they're still new to the package, it brings the usage section
right up near the top, so that they can get a sample of how the package
works and what they can expect.
3. It moves the available implementations to after the usage section,
simplifies the headers and descriptions of each one, and adds a usage
example for any that don't have one. The reason for this is that, to me,
using the FQN as the section header is redundant and too verbose. The
descriptions were reworked to read a little more like a narrative, yet
still maintain the focus of a core documentation guide. I tried hard to
make the text flow, yet still be active and to the point. There should
be usage examples for each one, as you can never be sure which one the
user may be most interested in, which one they need, and for
completeness sake. I also sorted the hydrators in to what seemed to be
the most applicable order of complexity, from the most basic to the most
advanced.

Signed-off-by: Matthew Setter <[email protected]>
Signed-off-by: Matthew Setter <[email protected]>
This patch incorporates feedback as provided by @froschdesign.

Signed-off-by: Matthew Weier O'Phinney <[email protected]>
Updates the CHANGELOG.md to set the release date.
@weierophinney weierophinney merged commit e7b1845 into 3.2.x Oct 6, 2020
@weierophinney weierophinney deleted the 3.1.x-merge-up-into-3.2.x_5f7c863e6e99e1.26585980 branch October 6, 2020 15:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants