1
0
Fork 0
tuned/doc/guide
Jaroslav Škarvada 94d70899c9
doc: installed html instead of the adoc
Also added support to the Makefile and spec.

Signed-off-by: Jaroslav Škarvada <jskarvad@redhat.com>
2019-03-12 19:57:15 +01:00
..
assemblies doc: renamed tuned-documentation to guide 2019-03-12 19:02:22 +01:00
meta doc: renamed tuned-documentation to guide 2019-03-12 19:02:22 +01:00
modules/performance doc: renamed tuned-documentation to guide 2019-03-12 19:02:22 +01:00
Makefile doc: installed html instead of the adoc 2019-03-12 19:57:15 +01:00
master.adoc doc: renamed tuned-documentation to guide 2019-03-12 19:02:22 +01:00
README.adoc doc: renamed tuned-documentation to guide 2019-03-12 19:02:22 +01:00

= About this documentation

This directory contains source files of Tuned documentation intended for system administrators.

== Building the source

The documentation is written in the *AsciiDoc* markup language. To build it, install the link:https://asciidoctor.org/[asciidoctor] utility and use it to convert the master file:

----
$ asciidoctor doc/tuned-documentation/master.adoc
----

This generates the `master.html` file, which you can open with your web browser.

== Structure

The `master.adoc` file is the main entry point for the documentation. It _includes_ (or, imports, loads) _assembly_ files from the `assemblies/` directory, which represent user stories. These assembly files then include _modules_ located in `modules/performance/`. Modules are reusable sections of content representing a concept, a procedure, or a reference.