Skip to content

Commit 53ea32c

Browse files
author
Edmundo Alvarez
committed
Add readme
1 parent b2a900b commit 53ea32c

File tree

1 file changed

+31
-2
lines changed

1 file changed

+31
-2
lines changed

README.md

+31-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,31 @@
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

Comments
 (0)