aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlexander Ziaee <ziaee@FreeBSD.org>2025-03-29 17:16:09 +0000
committerAlexander Ziaee <ziaee@FreeBSD.org>2025-04-19 19:48:54 +0000
commit77ba8a655507ac707d111c800f84d5138d0fa841 (patch)
treeea7594b0acf05039532ebd39e66713a69c17884d
parent908bb54878e9c3d1125d7bfac4c4df8cf1aaac89 (diff)
-rw-r--r--documentation/content/en/books/fdp-primer/writing-style/_index.adoc6
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.