35 lines
1.2 KiB
Markdown
35 lines
1.2 KiB
Markdown
|
# Fedora Policies
|
|||
|
|
|
|||
|
|
Please report Issues and submit Pull Requests for **Content Fixes** here.
|
|||
|
|
Never done a pull request (or "PR")? Here's the [Pagure documentation for
|
|||
|
|
Pull Requests](https://docs.pagure.org/pagure/usage/pull_requests.html).
|
|||
|
|
|
|||
|
|
Note that since this is official Fedora Council documentation, changes
|
|||
|
|
need agreement from the Council first. (For these, file a
|
|||
|
|
[Council ticket](https://pagure.io/Fedora-Council/tickets/)).
|
|||
|
|
|
|||
|
|
General appearance issues and publishing issues should be reported against
|
|||
|
|
the [publishing software](https://pagure.io/fedora-docs/docs-fp-o).
|
|||
|
|
|
|||
|
|
## How to edit these documents
|
|||
|
|
|
|||
|
|
All of this is written in AsciiDoc. It's a simple mostly-plain-text
|
|||
|
|
markup language. You may want to look at:
|
|||
|
|
|
|||
|
|
* [AsciiDoc Syntax Quick Reference](http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/)
|
|||
|
|
* [AsciiDoc Writer’s Guide](http://asciidoctor.org/docs/asciidoc-writers-guide/)
|
|||
|
|
* [Asciidoctor Diagram](http://asciidoctor.org/docs/asciidoctor-diagram/) (We use ditaa)
|
|||
|
|
|
|||
|
|
## Testing your changes locally
|
|||
|
|
|
|||
|
|
To test your changes, first install `asciibinder`
|
|||
|
|
|
|||
|
|
$ gem install ascii_binder
|
|||
|
|
|
|||
|
|
To build your changes, from the root directory:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
$ asciibinder package
|
|||
|
|
$ firefox _package/main/index.html
|
|||
|
|
```
|