Skip to content

Commit

Permalink
Update README file for NPM. (#158)
Browse files Browse the repository at this point in the history
* Add npm and travis badges to README.md.

* Move README to plugin directory and symlink to root directory. This should ensure that the README file will appear on NPM.

* Update README to include info about running NPM package.
  • Loading branch information
jburger424 committed Nov 7, 2019
1 parent e9c7886 commit 971293f
Show file tree
Hide file tree
Showing 2 changed files with 83 additions and 57 deletions.
57 changes: 0 additions & 57 deletions README.md

This file was deleted.

1 change: 1 addition & 0 deletions README.md
82 changes: 82 additions & 0 deletions lighthouse-plugin-publisher-ads/README.md
@@ -0,0 +1,82 @@
# Publisher Ads Lighthouse Plugin (Beta)
[![Linux Build Status](https://img.shields.io/travis/googleads/publisher-ads-lighthouse-plugin/master.svg)](https://travis-ci.org/googleads/publisher-ads-lighthouse-plugin)
[![NPM lighthouse package](https://img.shields.io/npm/v/lighthouse-plugin-publisher-ads.svg)](https://npmjs.org/package/lighthouse-plugin-publisher-ads)

Publisher Ads Lighthouse Plugin is a tool to improve ad speed and overall quality through a series of automated audits. At the moment, this is primarily targeted at sites using Google Ad Manager. This tool will aid in resolving discovered problems, providing a tool to be used to evaluate effectiveness of iterative changes while suggesting actionable feedback.

This tool is a plugin for [Lighthouse](https://github.com/GoogleChrome/lighthouse), an open-sourced tool integrated into Chrome dev tools that is widely used by developers.

We are currently in beta and still in the development process. In order to help us improve please [file an issue](https://github.com/googleads/publisher-ads-lighthouse-plugin/issues) to let us know of any issues or suggestions you may have.

## Web App

We currently have a web app version of Publisher Ads Lighthouse Plugin. It is currently in beta and can be accessed at [developers.google.com/publisher-ads-audits](https://developers.google.com/publisher-ads-audits/).

## Lighthouse Node CLI

Publisher Ads Audits is available as a [node package](https://npmjs.org/package/lighthouse-plugin-publisher-ads) which can be used with the Lighthouse CLI.

> **Note**: There is currently a [bug](https://github.com/googleads/publisher-ads-lighthouse-plugin/issues/159) specifically affecting global installs of of this package. Until this bug is resolved this should exclusively be used as a **local** install.
### Setup
```sh
mkdir pub-ads-audits-wrapper && cd pub-ads-audits-wrapper && \
npm init -y && \
yarn add -D lighthouse && \
yarn add -D lighthouse-plugin-publisher-ads
```

### Usage
>From within `wrapper` directory
```sh
yarn lighthouse {url} --plugins=lighthouse-plugin-publisher-ads
```
See [Lighthouse documentation](https://github.com/GoogleChrome/lighthouse/#cli-options) for additional options.

## Development

### Setup

```sh
git clone git@github.com:googleads/publisher-ads-lighthouse-plugin.git
cd publisher-ads-lighthouse-plugin
yarn
```

### Usage

```sh
node index.js <url>
```

Available options:
- `--view`: Open report in Chrome after execution.
- `--full`: Run all Lighthouse categories.
- Any other [Lighthouse flags](https://github.com/GoogleChrome/lighthouse/#cli-options).

Some common options are:

- `--additional-trace-categories=performance` to include general web
performance audits.
- `--emulated-form-factor=desktop` to run on the desktop version of the site.
- `--extra-headers "{\"Cookie\":\"monster=blue\"}"` to include additional
cookies on all requests.

### Tests
```sh
# Lint and test all files.
yarn test
```


## Contributions

See [CONTRIBUTING.md](https://github.com/googleads/publisher-ads-lighthouse-plugin/blob/master/CONTRIBUTING.md)




## References

- Lighthouse Docs: https://github.com/GoogleChrome/lighthouse
- DevTools Protocol: https://chromedevtools.github.io/devtools-protocol

0 comments on commit 971293f

Please sign in to comment.