clarify in the beginning what we mean by cipherstring A and B
authorAaron Kaplan <aaron@lo-res.org>
Tue, 3 Jun 2014 17:34:28 +0000 (19:34 +0200)
committerAaron Kaplan <aaron@lo-res.org>
Tue, 3 Jun 2014 17:34:28 +0000 (19:34 +0200)
src/howtoread.tex

index 64669ac..41abcca 100644 (file)
@@ -1,10 +1,24 @@
 \section{How to read this guide}
 \label{sec:how-read-this}
-This guide tries to accommodate two needs: first of all, having a handy reference on how to configure the most common services's crypto settings and second of all, explaining a bit, how to chose your own cipher settings.
+This guide tries to accommodate two needs: first of all, having a handy reference on how to configure the most common services' crypto settings and second of all, explain a bit of background on cryptography. This background is essential if the reader wants to chose his or her own cipher string settings.
 
-System administrators who want to copy \& paste recommendations quickly without spending a lot of time on background reading on cryptography or cryptanalysis can do so, by simply searching for the corresponding section in chapter \ref{chapter:PracticalSettings} (``Practical recommendations''). However, for the quick copy \& paste approach it is important to know that this guide assumes users are happy with \textit{cipher String B} which is the baseline and most compatible recommendation that the authors came up with. \textit{Cipher string B} is described in \ref{section:recommendedciphers}. \textit{Cipher String B} covers the most common use-cases (such as running an e-commerce shop, a private homepage, a mail server, $ \ldots $)
+System administrators who want to copy \& paste recommendations quickly without
+spending a lot of time on background reading on cryptography or cryptanalysis
+can do so, by simply searching for the corresponding section in chapter
+\ref{chapter:PracticalSettings} (``Practical recommendations''). 
 
-While chapter \ref{chapter:PracticalSettings} is intended to serve as a copy \& paste reference, chapter \ref{chapter:Theory} (``Theory'') explains the reasoning behind \textit{cipher string B}. In particular, section \ref{section:CipherSuites} explains how to choose individual cipher strings. We advise the reader to actually read this section and challenge our reasoning in choosing \textit{cipher string B} and to come up with a better  or localized solution.
+It is important to know that in this guide the authors arrived at two recommendations: \textit{Cipher string A} and \textit{Cipher string B}. While the former is a hardened recommendation the latter is a weaker one but provides wider compatibility.
+\textit{Cipher strings A and B} are described in \ref{section:recommendedciphers}. 
+
+%\textit{Cipher
+%string B} covers the most common use-cases (such as running an e-commerce shop,
+%a private homepage, a mail server, $ \ldots $).
+
+However, for the quick copy \& paste approach it is important to know that this
+guide assumes users are happy with \textit{Cipher string B}. 
+
+
+While chapter \ref{chapter:PracticalSettings} is intended to serve as a copy \& paste reference, chapter \ref{chapter:Theory} (``Theory'') explains the reasoning behind \textit{cipher string B}. In particular, section \ref{section:CipherSuites} explains how to choose individual cipher strings. We advise the reader to actually read this section and challenge our reasoning in choosing \textit{Cipher string B} and to come up with a better  or localized solution.
 
 %We start with some general remarks in sections \ref{section:DH},\ref{section:EllipticCurveCryptography},\ref{section:keylengths} on 
 %If you are a system administrator and want to quickly update your services, jump right to section \ref{section:PracticalSettings}. However, we recommend that you take some time and first read through the theory part (chapter \ref{chapter:Theory}), especially section \ref{section:CipherSuites} on how to choose your own cipher string and then adapt the settings in section \ref{section:PracticalSettings} to your own needs.