X-Git-Url: http://www.git.cypherpunks.ru/?p=pyderasn.git;a=blobdiff_plain;f=doc%2Findex.rst;h=b9c56a343534d7728abe5d83fbe59d261cf91a3d;hp=0197abd30efb6c9dfd4a572e4ea178b7cb3a85b6;hb=HEAD;hpb=3bdec8f765e0fa8ed27162a8c0abe391a44dc664

diff --git a/doc/index.rst b/doc/index.rst
index 0197abd..b9c56a3 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -1,6 +1,6 @@
-========================================
-PyDERASN -- ASN.1 DER library for Python
-========================================
+================================================================
+PyDERASN -- strict and fast ASN.1 DER/CER/BER library for Python
+================================================================
 
 ..
 
@@ -8,27 +8,23 @@ PyDERASN -- ASN.1 DER library for Python
     (C) PyDERASN's author
 
 `ASN.1 <https://en.wikipedia.org/wiki/ASN.1>`__ (Abstract Syntax
-Notation One) is a standard for abstract data serialization.
-`DER <https://en.wikipedia.org/wiki/Distinguished_Encoding_Rules>`__
-(Distinguished Encoding Rules) is a subset of encoding rules suitable
-and widely used in cryptography-related stuff. PyDERASN is yet another
-library for dealing with the data encoded that way. Although ASN.1 is
-written more than 30 years ago by wise Ancients (taken from ``pyasn1``'s
-README), it is still often can be seen anywhere in our life.
+Notation One) is a standard for abstract data serialization. PyDERASN is
+yet another library for dealing with ASN.1 structures, decoding them in
+`BER/CER/DER <https://en.wikipedia.org/wiki/X.690>`__ formats and
+encoding to either DER (Distinguished Encoding Rules) or CER (Canonical
+Encoding Rules). Although ASN.1 is written more than 30 years ago by wise
+Ancients (taken from ``pyasn1``'s README), it is still often can be seen
+anywhere in our life.
 
 PyDERASN is `free software <https://www.gnu.org/philosophy/free-sw.html>`__,
-licenced under `GNU LGPLv3+ <https://www.gnu.org/licenses/lgpl-3.0.html>`__.
-
-.. figure:: pprinting.png
-   :alt: Pretty printing example output
-
-   An example of pretty printed X.509 certificate with automatically
-   parsed DEFINED BY fields.
+licenced under `GNU LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>`__.
 
 .. toctree::
    :maxdepth: 1
 
    features
+   performance
+   limitations
    examples
    reference
    news
@@ -36,3 +32,19 @@ licenced under `GNU LGPLv3+ <https://www.gnu.org/licenses/lgpl-3.0.html>`__.
    download
    thanks
    feedback
+
+There are articles about its history and usage:
+
+* `Как я написал ASN.1 библиотеку с slots and blobs <https://m.habr.com/ru/post/444272/>`__ (on russian)
+* `Как я добавил big-data поддержку <https://m.habr.com/ru/post/498014/>`__ (on russian)
+
+.. figure:: pprinting.webp
+   :alt: Pretty printing example output
+
+   An example of pretty printed X.509 certificate with automatically
+   parsed DEFINED BY fields.
+
+.. figure:: browser.webp
+   :alt: ASN.1 browser example
+
+   An example of browser running.