Skip to content

Commit 6792e0d

Browse files
authored
Merge pull request #27 from Webperf-se/readme
Improved README with example and plugin info
2 parents 3778320 + 4606a67 commit 6792e0d

File tree

1 file changed

+25
-4
lines changed

1 file changed

+25
-4
lines changed

README.md

Lines changed: 25 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,17 @@ webperf-core plugin for sitespeed.io.
66

77
The `plugin-webperf-core` is a plugin used by the [webperf_core](https://github.com/Webperf-se/webperf_core) repository. It is designed to collect data from other sitespeed.io plugins, such as [@sitespeedio/plugin-lighthouse](https://github.com/sitespeedio/plugin-lighthouse). The main goal of this plugin is to move sitespeed.io specific logic into sitespeed.io plugins instead of having them directly in `webperf_core`.
88

9+
Additionally, this plugin summarizes supported plugins into a single tab (webperf core), instead of each plugin having its own tab. This approach makes it easier to get a quick overview, reduces clutter, and simplifies identifying the best next issue to improve.
10+
911
## Features
1012

11-
- Collects data from various sitespeed.io plugins like [@sitespeedio/plugin-lighthouse](https://github.com/sitespeedio/plugin-lighthouse).
13+
- Collects data from various sitespeed.io plugins like:
14+
- [plugin-css](https://github.com/Webperf-se/plugin-css)
15+
- [plugin-html](https://github.com/Webperf-se/plugin-html)
16+
- [plugin-javascript](https://github.com/Webperf-se/plugin-javascript)
17+
- [plugin-pagenotfound](https://github.com/Webperf-se/plugin-pagenotfound)
18+
- [plugin-accessibility-statement](https://github.com/Webperf-se/plugin-accessibility-statement)
19+
- [@sitespeedio/plugin-lighthouse](https://github.com/sitespeedio/plugin-lighthouse)
1220
- Centralizes sitespeed.io specific logic, keeping it separate from the `webperf_core` repository.
1321
- Provides a streamlined integration with sitespeed.io for better maintainability and modularity.
1422
- Enables easy configuration and use within sitespeed.io environments.
@@ -21,6 +29,12 @@ To install the plugin, run the following command:
2129
npm install plugin-webperf-core
2230
```
2331

32+
It is also recommended to install the related plugins listed in the Features section for full functionality:
33+
34+
```sh
35+
npm install plugin-css plugin-html plugin-javascript plugin-pagenotfound plugin-accessibility-statement @sitespeedio/plugin-lighthouse
36+
```
37+
2438
## Usage
2539

2640
To use the plugin with sitespeed.io, add it to your sitespeed.io configuration file or command line options.
@@ -47,12 +61,14 @@ You can also enable the plugin via the command line:
4761
sitespeed.io --plugins.add plugin-webperf-core
4862
```
4963

64+
Remember to also add all plugins you want to have information from, like the plugin-javascript plugin.
65+
5066
## Example
5167

5268
Here is an example of how to use the plugin with sitespeed.io:
5369

5470
```sh
55-
sitespeed.io https://www.example.com --plugins.add plugin-webperf-core
71+
sitespeed.io --plugins.add plugin-webperf-core --plugins.add plugin-css --plugins.add plugin-html --plugins.add plugin-javascript --plugins.add plugin-pagenotfound --plugins.add plugin-accessibility-statement --plugins.add @sitespeedio/plugin-lighthouse https://www.example.com
5672
```
5773

5874
## Development
@@ -89,6 +105,11 @@ Contributions are welcome! Please open an issue or submit a pull request on GitH
89105

90106
## Acknowledgements
91107

92-
- [sitespeed.io](https://www.sitespeed.io/)
93-
- [webperf-sitespeedio-plugin](https://www.npmjs.com/package/webperf-sitespeedio-plugin)
108+
- [plugin-css](https://github.com/Webperf-se/plugin-css)
109+
- [plugin-html](https://github.com/Webperf-se/plugin-html)
110+
- [plugin-javascript](https://github.com/Webperf-se/plugin-javascript)
111+
- [plugin-pagenotfound](https://github.com/Webperf-se/plugin-pagenotfound)
112+
- [plugin-accessibility-statement](https://github.com/Webperf-se/plugin-accessibility-statement)
113+
- [@sitespeedio/plugin-lighthouse](https://github.com/sitespeedio/plugin-lighthouse)
94114
- [webperf_core](https://github.com/Webperf-se/webperf_core)
115+
- [sitespeed.io](https://www.sitespeed.io/)

0 commit comments

Comments
 (0)