|
1 |
| -# frontend-documentation |
2 |
| -Graylog frontend documentation and component gallery |
| 1 | +# Graylog frontend documentation |
| 2 | +Graylog frontend documentation and component gallery. See the live version at: |
| 3 | + |
| 4 | +[https://graylog2.github.io/frontend-documentation/](https://graylog2.github.io/frontend-documentation/) |
| 5 | + |
| 6 | +### Run documentation locally |
| 7 | +You can run a local version of the documentation from the [graylog2-server](https://github.com/Graylog2/graylog2-server) repository: |
| 8 | + |
| 9 | +1. Clone [graylog2-server](https://github.com/Graylog2/graylog2-server) |
| 10 | +2. Go to the `graylog2-web-interface` folder: |
| 11 | + |
| 12 | + `cd graylog2-web-interface` |
| 13 | +3. Install the web interface requirements |
| 14 | +4. Run `yarn install` |
| 15 | +5. Run `yarn run docs:server` |
| 16 | +6. Go to `http://localhost:6060` on your favourite browser to see the site |
| 17 | + |
| 18 | +### Contribute |
| 19 | +**NOTE** The contents of this repository are auto-generated by [React Styleguidist](https://react-styleguidist.js.org) and you should not edit them by hand. |
| 20 | + |
| 21 | +You can contribute to the documentation by: |
| 22 | +- Editing the markdown files under `https://github.com/Graylog2/graylog2-server/tree/master/graylog2-web-interface/docs` |
| 23 | +- Editing the inline JSDoc documentation for components in `https://github.com/Graylog2/graylog2-server/tree/master/graylog2-web-interface/src/components` |
| 24 | +- Editing the example markdown files for components in `https://github.com/Graylog2/graylog2-server/tree/master/graylog2-web-interface/src/components` |
| 25 | + |
| 26 | +Please note that only documentation for components that are more likely to be shared is currently published in the component gallery. Namely, these are the folders we publish: |
| 27 | +- `src/components/bootstrap` |
| 28 | +- `src/components/common` |
| 29 | +- `src/components/configurationforms` |
| 30 | +- `src/components/inputs |
| 31 | +- `src/components/visualizations` |
0 commit comments