2021-11-10 19:20:56 +10:00
|
|
|
# Fedora Infrastructure Documentation
|
2019-09-15 11:14:53 +02:00
|
|
|
|
2021-11-10 19:20:56 +10:00
|
|
|
This repository contains the sources for the documentation related to the Fedora Infrastructure
|
2019-09-15 11:14:53 +02:00
|
|
|
team.
|
|
|
|
|
2021-11-10 19:20:56 +10:00
|
|
|
The Documentation is built and available to read on the Fedora Documentation site at:
|
2019-09-15 11:14:53 +02:00
|
|
|
|
2021-11-10 19:20:56 +10:00
|
|
|
https://docs.fedoraproject.org/en-US/infra/
|
|
|
|
|
|
|
|
|
|
|
|
## Previewing the documentation
|
2019-09-15 11:14:53 +02:00
|
|
|
|
|
|
|
To build and preview the site, run:
|
|
|
|
|
|
|
|
```
|
|
|
|
$ ./build.sh && ./preview.sh
|
|
|
|
```
|
|
|
|
|
|
|
|
The result will be available at http://localhost:8080
|
|
|
|
|
2021-11-10 19:20:56 +10:00
|
|
|
## Writing the documentation
|
|
|
|
|
|
|
|
The Fedora Infrastructure Documentation uses asciidoc as the source markup.
|
|
|
|
|
|
|
|
Below are some resources to help you get started with asciidoc:
|
2019-09-15 11:14:53 +02:00
|
|
|
|
|
|
|
* asciidoc syntax cheatsheet: https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/
|
|
|
|
* asciidoc full user manual: https://asciidoctor.org/docs/user-manual/
|
|
|
|
* Antora's documentation: https://docs.antora.org/antora/2.0/
|
|
|
|
|
2021-11-10 19:20:56 +10:00
|
|
|
## License
|
|
|
|
|
2019-09-15 11:14:53 +02:00
|
|
|
This documentation is made available under CC-BY-SA 3.0
|