34 lines
1.2 KiB
Markdown
34 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
|
||
```
|