-
Notifications
You must be signed in to change notification settings - Fork 130
Closed
Labels
InfrastructureIssues for the overall performance plugin infrastructureIssues for the overall performance plugin infrastructure[Plugin] Performance LabIssue relates to work in the Performance Lab Plugin onlyIssue relates to work in the Performance Lab Plugin only[Type] EnhancementA suggestion for improvement of an existing featureA suggestion for improvement of an existing feature
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.txt
file for the WebP Uploads standalone plugin should be added to theimage/webp-uploads
module 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-ignore
rule should be added to.gitattributes
that ensures that noreadme.txt
file 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.txt
file though. - As a result of the above, we need to ensure that the
webp-uploads
standalone plugin built via thebuild-plugins
script from Implement CLI command to for a build process to transform modules into standalone plugins #635 now contains the newreadme.txt
file.
Metadata
Metadata
Assignees
Labels
InfrastructureIssues for the overall performance plugin infrastructureIssues for the overall performance plugin infrastructure[Plugin] Performance LabIssue relates to work in the Performance Lab Plugin onlyIssue relates to work in the Performance Lab Plugin only[Type] EnhancementA suggestion for improvement of an existing featureA suggestion for improvement of an existing feature