-
Notifications
You must be signed in to change notification settings - Fork 138
Description
Feature Description
Follow up to #635: Since we're going to publish modules as individual plugins, we will need to have readme.txt files for them. While this is required for the plugins anyway, it is also a great way for us to provide an overview for each individual module in the GitHub repository.
We can add a README.md file in every module directory and then potentially transform it into a readme.txt in a build step; or alternatively we can simply format the README.md file as a plugin readme from the very start (see https://johnblackbourn.com/readme-md-plugin-on-wordpress-org/).
For the initial scope of this implementation, let's limit the work to just the images/webp-uploads module, similar to #635.
Requirements
- A
readme.txtfile for the WebP Uploads standalone plugin should be added to theimage/webp-uploadsmodule folder. Some notes on the content:- We should focus on a basic foundation, let's not get too caught up in the initial readme content. We can always iterate.
- The readme can generally follow what the overall Performance Lab readme contains, however of course scoped to just the future standalone WebP Uploads plugin.
- Let's use version number 1.0.0.
- For the short description of the plugin, we can use what's currently the short description of the module. Maybe we can tweak it to start with "WordPress core feature plugin to ..." (do xyz)
- For the longer description, we don't need to provide too much detail for now since this issue is mainly about setting up a minimum viable readme version. It would be a good idea to include links that provide more context, e.g. to the different WebP for WordPress core proposal posts and the Trac ticket.
- The Installation and FAQ sections can be almost taken over from Performance Lab as is, since the questions are all either generic (just need minor tweaks to focus on "WebP Uploads" instead of "Performance Lab") or already specific to the WebP feature.
- Let's start with a fresh changelog, just to cover the upcoming initial 1.0.0 release.
- A new
export-ignorerule should be added to.gitattributesthat ensures that noreadme.txtfile from any module directory is included in an overall ZIP build, so that the overall Performance Lab plugin ZIP build does not include those readme files. Of course it still needs to include its ownreadme.txtfile though. - As a result of the above, we need to ensure that the
webp-uploadsstandalone plugin built via thebuild-pluginsscript from Implement CLI command to for a build process to transform modules into standalone plugins #635 now contains the newreadme.txtfile.