From 9e50993d2f7698e9d1d29a422e1595763a7bbf05 Mon Sep 17 00:00:00 2001
From: Sergey Matveev <stargrave@stargrave.org>
Date: Sun, 10 Jan 2016 21:42:03 +0300
Subject: [PATCH] [DOC] FAQ additions

Signed-off-by: Sergey Matveev <stargrave@stargrave.org>
---
 doc/faq.ru.texi | 12 ++++++++++++
 doc/faq.texi    | 17 ++++++++++++++---
 2 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/doc/faq.ru.texi b/doc/faq.ru.texi
index 22ac58e..9035137 100644
--- a/doc/faq.ru.texi
+++ b/doc/faq.ru.texi
@@ -85,6 +85,11 @@ Go очень легко читается, поддаётся ревью и по
 виду, что этот режим требователен к ресурсам и трафику и пока работает
 только в TCP режиме.
 
+@item Вы думаете нешифрованный режим с его случайными данными поможет в суде?
+Если всё что не может быть прочитано кем-угодно считается шифрованием,
+то нет, этот режим вам не поможет. Представьте что вы говорите на другом
+иностранном языке или просто используете другую схему кодирования данных.
+
 @item Когда я должен использовать @ref{Noise, noise} опцию?
 В большинстве случаев она вам не нужна без включённого
 @ref{CPR, постоянного по скорости трафика} (CPR). Без CPR и шума, в
@@ -101,4 +106,11 @@ UMAC алгоритмом -- в большинстве случаев потре
 обрабатывается только если зашифрованный @ref{Identity, идентификатор}
 клиента найден: он использует быстрый PRP без потребления энтропии.
 
+@item Почему YAML для конфигурации?
+Есть не так много хорошо известных форматов позволяющих комментировать,
+легко редактировать людьми (XML совсем не дружелюбен к человеку, JSON
+более менее). Возможно самое важное свойство это шаблоны YAML: очень
+удобно сохранить много клиентов, имеющих схожие настройки, в одном
+конфигурационном файле.
+
 @end table
diff --git a/doc/faq.texi b/doc/faq.texi
index e6986cd..c9da019 100644
--- a/doc/faq.texi
+++ b/doc/faq.texi
@@ -75,10 +75,7 @@ at the traffic (transport and handshake).
 
 @cindex Censorship
 @cindex Censorship resistance
-@cindex Censorship resistant
-@cindex DPI resistant
 @cindex DPI resistance
-@cindex DPI
 @item What do you mean by censorship resistance?
 Unability to distinguish either is it GoVPN-traffic is passing by, or
 just @code{cat /dev/urandom | nc somehost}. If you can not differentiate
@@ -95,6 +92,12 @@ provides confidentiality and authenticity of transmitted data! But pay
 attention that this mode is traffic and resource hungry and currently
 operate only in TCP mode.
 
+@item Do you think encryptionless mode with all those random data helps in court?
+If anything that can not be read by anyone is considered encryption,
+then no, encryptionless mode won't help you. Imagine that either you are
+talking on another foreign language, or just use another date encoding
+scheme.
+
 @item When should I use @ref{Noise, noise} option?
 In most cases you won't need it without @ref{CPR, constant packer rate}
 turned on. Without CPR and noise options GoVPN traffic (like TLS, IPsec,
@@ -111,4 +114,12 @@ be higher then UMAC verifying. Each handshake message is processed only
 when an encrypted client's @ref{Identity, identity} is found: it uses
 fast PRP without any entropy usage.
 
+@cindex Why YAML
+@item Why YAML for configuration?
+There are not so many well-known formats that allow commenting, easy
+editing by human (XML is not human friendly at all, JSON is more or
+less). Probably the most useful feature is YAML's templates: it is very
+convenient for storing many clients sharing the same options in the
+configuration file.
+
 @end table
-- 
2.44.0