Add an article about recent libraries deprecation.#20
Add an article about recent libraries deprecation.#20shulard wants to merge 1 commit intohoaproject:masterfrom
Conversation
83ed08c to
c45ea94
Compare
c45ea94 to
ee85441
Compare
Hywan
left a comment
There was a problem hiding this comment.
Despites some modifications, the post looks good to me. It is clear, and we understand the motivations. Thanks your very much!
| <p>Hoa is a set of 61 PHP libraries, during our <a href="http://discourse.hoa-project.net/t/hoa-virtual-meeting/22/34">latest | ||
| Virtual Meeting</a> we choose to deprecate some libraries. This is important | ||
| for us to ensure that Hoa stays relevant and up to date regarding real | ||
| world needs.<br/> |
| Virtual Meeting</a> we choose to deprecate some libraries. This is important | ||
| for us to ensure that Hoa stays relevant and up to date regarding real | ||
| world needs.<br/> | ||
| We choose to remove the ones that are:</p> |
There was a problem hiding this comment.
- We choose to
+ We have decided to| world needs.<br/> | ||
| We choose to remove the ones that are:</p> | ||
| <ol> | ||
| <li>Un-used or unpopular,</li> |
There was a problem hiding this comment.
“Unpopular” in this context means libraries that people don't like. This is wrong in some regards.
I would rephrase like this:
Basically un-used (with less than 100 downloads in 5 years).
| <li>Not relevant anymore because they refer to dead technologies.</li> | ||
| </ol> | ||
| <p>The main goal is to reduce the effort to maintain the Hoa ecosystem.</p> | ||
| <p>To be sure about the list, we checked some packagist and github stats. |
There was a problem hiding this comment.
- some packagist and github stats
+ Packagist and GitHub statistics| </ol> | ||
| <p>The main goal is to reduce the effort to maintain the Hoa ecosystem.</p> | ||
| <p>To be sure about the list, we checked some packagist and github stats. | ||
| We also choose to keep the one used internally at the moment.</p> |
There was a problem hiding this comment.
- the one used internally
+ the ones we use for private projects| <p>The main goal is to reduce the effort to maintain the Hoa ecosystem.</p> | ||
| <p>To be sure about the list, we checked some packagist and github stats. | ||
| We also choose to keep the one used internally at the moment.</p> | ||
| <p>Some of the libraries weren't registered on packagist which means that |
| <p>The deprecation process is simple:</p> | ||
| <ol> | ||
| <li>Abandon the project on Packagist,</li> | ||
| <li>Update the README.md file to inform users,</li> |
There was a problem hiding this comment.
- README.md
+ <code>README.md</code>| <ol> | ||
| <li>Abandon the project on Packagist,</li> | ||
| <li>Update the README.md file to inform users,</li> | ||
| <li>Archive the repository on Github.</li> |
There was a problem hiding this comment.
You can add that mirrors are also updated to reflect this change.
| </ol> | ||
| <p>Here is the whole list of deprecated libraries:</p> | ||
| <ul> | ||
| <li><a href="https://github.com/hoaproject/cache">hoa/cache</a></li> |
There was a problem hiding this comment.
- hoa/cache</a>
+ <code>hoa/cache</code></a>,etc.
We choose to drop unused, unpopular and not relevant part of Hoa and it's important to write about that. Related to : hoaproject/Central#90
ee85441 to
842ab6f
Compare
|
Hello @Hywan, I've updated the article with all your feedbacks 😄. |
We choose to drop unused, unpopular and not relevant part of Hoa and it's important to write about that.
Related to : hoaproject/Central#90
It's a quick and simple article, maybe we need to add more details ?