#799 README: add information how to build guidelines
Merged 10 months ago by tibbs. Opened 10 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

10 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