MANIFEST.in |  1 +
 faq.texi    | 29 +++++++++++++++++++++++++++++
 maketxts.sh |  9 +++++++++
 setup.py    |  1 +
 www.texi    |  1 +

diff --git a/MANIFEST.in b/MANIFEST.in
index 577c5417126d806297adc678a1510fa37736813cd564ac16efa09d30a01293d0..e80ba79ce09adeb59bada9496886c8fcdfce38899804ffe2e9c71dd6d33114c4 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,5 +1,6 @@
 include AUTHORS
 include COPYING
+include FAQ
 include INSTALL
 include NEWS
 include README
diff --git a/faq.texi b/faq.texi
new file mode 100644
index 0000000000000000000000000000000000000000..2c6c114a9fa1c5e8837600a031b8004261115164c5235db3b0487df91d5312bf
--- /dev/null
+++ b/faq.texi
@@ -0,0 +1,29 @@
+@node FAQ
+@unnumbered Frequently asked questions
+
+@set ItIsGOSTBaby It is GOST: do you expect serialization unification?
+
+@table @asis
+
+@item My signature is not validated by other implementations. What is wrong?
+
+Try to reverse it (@code{sign[::-1]}).
+Try to swap its halves (@code{sign[len(sign)/2:] + sign[:len(sign)/2]}).
+Try to reverse its swapped halves too.
+
+@value{ItIsGOSTBaby}!
+
+@item My signature is @strong{still} not validated by other implementations!
+
+Try to reverse digest you are signing/verifying (@code{dgst[::-1]}).
+
+@value{ItIsGOSTBaby}!
+
+@item Everything above did not help me. Does PyGOST sucks?
+
+No way! You still have not tried to reverse your binary private key,
+public key and swap its halves.
+
+@value{ItIsGOSTBaby}!
+
+@end table
diff --git a/maketxts.sh b/maketxts.sh
index db2cd7fe362b90db5d9e841c2df3417ae293f47d35b0d7e5f0aaca451d848615..db0cb3e5658ca09c71d1b4f2a81002a6b4589dc29fac47a0704c1175c2c24b06 100755
--- a/maketxts.sh
+++ b/maketxts.sh
@@ -29,6 +29,15 @@ @bye
 EOF
 makeinfo --plaintext -o INSTALL $texi
 
+cat > $texi <<EOF
+\input texinfo
+@documentencoding UTF-8
+@settitle FAQ
+@include faq.texi
+@bye
+EOF
+makeinfo --plaintext -o FAQ $texi
+
 rm -f $texi
 
 git checkout download.texi install.texi
diff --git a/setup.py b/setup.py
index 17de7f23bf9c0db69df4961e497ab6c35f515aae312522a7a18cc2159edebb67..8b8f2f3122805962683d83a1b9185be6f32a2e9d7c184d0a55e7fdb437f4ce69 100644
--- a/setup.py
+++ b/setup.py
@@ -30,6 +30,7 @@     data_files=(
         ('', (
             "AUTHORS",
             "COPYING",
+            "FAQ",
             "INSTALL",
             "NEWS",
             "README",
diff --git a/www.texi b/www.texi
index 1f1ee23f59c34d793ac841efabe0be442c6ca97db33baec87586cb3ee248553c..aa3ce9c014d0d3298753fa1b3b571d641227d6e137f47211d4d2a96a12b4b961 100644
--- a/www.texi
+++ b/www.texi
@@ -88,6 +88,7 @@ mailing list. Announcements also go to this mailing list.
 
 @insertcopying
 
+@include faq.texi
 @include news.texi
 @include install.texi