#799 README: add information how to build guidelines
Merged 7 months ago by tibbs. Opened 7 months ago by ignatenkobrain.
ignatenkobrain/packaging-committee readme  into  master

file added
+42

@@ -0,0 +1,42 @@ 

+ # Fedora Packaging Committee

+ 

+ Welcome!  This is the pagure instance for the Fedora Packaging Committee.

+ 

+ The pagure repository is used to store source of Packaging Guidelines,

+ track related issues

+ and accept changes via pull requests.

+ 

+ For more information on the committee and its processes,

+ see the page in the main Fedora wiki [here](https://fedoraproject.org/wiki/Packaging_Committee).

+ 

+ ## Packaging Guidelines

+ 

+ ### Building and viewing

+ 

+ Prerequisites:

+ 

+ * `make`

+ * `podman`

+ * `python3`

+ 

+ Run following commands and open http://localhost:8000/

+ 

+ ```

+ $ make

+ $ make serve

+ ```

+ 

+ ### Writing

+ 

+ [Antora](https://antora.org/) is used for managing guidelines

+ and integrating it into the rest of Fedora Documentation.

+ You can find useful links below.

+ 

+ * [AsciiDoc Syntax Quick Reference](https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/)

+ * [AsciiDoc Writer’s Guide](https://asciidoctor.org/docs/asciidoc-writers-guide/)

+ 

+ #### Rules

+ 

+ * Use [Semantic Line Breaks](http://sembr.org/)

+ * Prefer `https://example.com[here]` over `link:https://example.com[here]`

+ * Prefer `[#some-ref]` over `[[some-ref]]`

file removed
-10

@@ -1,10 +0,0 @@ 

- Fedora Packaging Committee

- ==========================

- 

- Welcome!  This is the pagure instance for the Fedora Packaging Committee.

- 

- The pagure issue tracker is used to track the status of drafts and sometimes

- vote on them. For more information on the committee and its processes, see the

- page in the main Fedora wiki here_.

- 

- .. _here: https://fedoraproject.org/wiki/Packaging_Committee

To be honest I figure you would just push something like this directly.

Pull-Request has been merged by tibbs

7 months ago

Looking at the result, there's some weirdness around one apostrophe (in "Writer's Guide"). It's not at all visible in the PR.

Maybe there's a unicode bug lurking somewhere.

Metadata