diff options
author | Alexander Ziaee <ziaee@FreeBSD.org> | 2025-03-29 17:16:09 +0000 |
---|---|---|
committer | Alexander Ziaee <ziaee@FreeBSD.org> | 2025-04-19 19:48:54 +0000 |
commit | 77ba8a655507ac707d111c800f84d5138d0fa841 (patch) | |
tree | ea7594b0acf05039532ebd39e66713a69c17884d | |
parent | 908bb54878e9c3d1125d7bfac4c4df8cf1aaac89 (diff) |
-rw-r--r-- | documentation/content/en/books/fdp-primer/writing-style/_index.adoc | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/documentation/content/en/books/fdp-primer/writing-style/_index.adoc b/documentation/content/en/books/fdp-primer/writing-style/_index.adoc index 1ade058e60..965998b9eb 100644 --- a/documentation/content/en/books/fdp-primer/writing-style/_index.adoc +++ b/documentation/content/en/books/fdp-primer/writing-style/_index.adoc @@ -14,7 +14,7 @@ params: = Writing Style :doctype: book :toc: macro -:toclevels: 1 +:toclevels: 2 :icons: font :sectnums: :sectnumlevels: 6 @@ -169,7 +169,7 @@ For more information about writing style, see http://www.bartleby.com/141/[Eleme To keep the source for the documentation consistent when many different people are editing it, please follow these style conventions. [[one-sentence-per-line]] -== One sentence per line +=== One sentence per line Use Semantic Line Breaks in the documentation, a technique called "one sentence per line". The idea of this technique is to help the users to write and read documentation. @@ -189,7 +189,7 @@ They are endowed with reason and conscience and should act towards one another i .... [[writing-style-acronyms]] -== Acronyms +=== Acronyms Acronyms should be defined the first time they appear in a document, as in: "Network Time Protocol (NTP)". After the acronym has been defined, use the acronym alone unless it makes more sense contextually to use the whole term. |