Skip to content

Latest commit

 

History

History
20 lines (12 loc) · 1.47 KB

FAQ.md

File metadata and controls

20 lines (12 loc) · 1.47 KB

docbook-samples FAQ

Why "docbook-samples" project and what does it mean?

There is nothing behind the name of the project. It means exactly what it is - just documentation samples in DocBook/XML 5.1 format :)

Why "docbook-samples" was created?

Short answer: to make things easy.

Long answer: An author has two projects: foponts and docbook pretty playout that both need to have some technical "near-real life" documentation samples to work with, that contains a bunch of markup features, with a complex structure and some text full of real continuous straightforward narration - not just a Lorem ipsum snippets.

How can I contact an author?

Just drop me a line to [email protected] with a "docbook-samples" in subject line. I'm very curious to hear who really needs to use this project with DocBook/XML source files.

For an author's opinion the project is useful only for and limited to the following two cases:

  • You are a contributor to an other author's projects foponts and docbook pretty playout and use this project as a git submodule.
  • You want to evaluate how an author creates technical documentation itself, including his writing style, attention to details, information structuring and presentation, layout and design, etc. :)