diff --git a/general/index.rst b/general/index.rst new file mode 100644 index 0000000000000000000000000000000000000000..67e480b550b3d0d0bebc5fbcd8ef08ca7b86abf3 --- /dev/null +++ b/general/index.rst @@ -0,0 +1,11 @@ +####### +General +####### + +This chapter introduces Jami and tries to answer the most common +questions. + +.. toctree:: + :maxdepth: 1 + + introduction diff --git a/general/introduction.rst b/general/introduction.rst new file mode 100644 index 0000000000000000000000000000000000000000..fb67cfe9945a0f64a90bb74ea76822037912226d --- /dev/null +++ b/general/introduction.rst @@ -0,0 +1,51 @@ +Introduction +============ + +.. image:: ../_static/logo-jami.svg + :alt: Jami logo + +Jami is a free/libre, end-to-end encrypted and private communication +platform that requires no central authority. + +Jami's features include: text chats, voice and video calls, screen +sharing, file sharing, conference calls, and group chats (:ref:`coming +soon <general/technical-overview:swarms>`). Jami can also function as +a regular SIP client. + +Jami works on GNU/Linux, Windows, macOS, iOS, and Android. Multiple +devices can be linked to a Jami account, and no personal information +is required to create an account. + +How does Jami work? +------------------- + +Jami uses a `distributed hash table +<https://en.wikipedia.org/wiki/Distributed_hash_table>`__ (DHT) to +connect peers. Jami accounts are asymmetric `X.509 certificates +<https://en.wikipedia.org/wiki/X.509>`__ generated by the GnuTLS +library. Calls are made over the `Session Initiation Protocol +<https://en.wikipedia.org/wiki/Session_Initiation_Protocol>`__ (SIP) +after negotiating a `TLS +<https://en.wikipedia.org/wiki/Transport_Layer_Security>`__-encrypted +secure connection, performing `Secure Real-time Transport Protocol +<https://en.wikipedia.org/wiki/Secure_Real-time_Transport_Protocol>`__ +(SRTP) communication which carries the media streams. + +For more on how Jami works, see the `Jami and how it empowers users +<https://kelar.org/~bandali/talks/libreplanet-2021-jami.html>`__ talk +by `Amin Bandali <https://kelar.org/~bandali/>`__, as well as the +:doc:`Technical Overview <technical-overview>` for more in-depth +information. + +Who makes Jami? +--------------- + +The Jami project is led by `Savoir-faire Linux +<https://www.savoirfairelinux.com/en/>`__ -- a Canadian/Québécois +GNU/Linux consulting company -- and is supported by a global community +of free software enthusiasts, users, and contributors. + +Jami is `free software +<https://www.gnu.org/philosophy/free-sw.html>`__ and an official +GNU package, developed and distributed under the `GNU GPLv3+ +<https://www.gnu.org/licenses/gpl-3.0.html>`__ license. diff --git a/index.rst b/index.rst index 5d2bf184a2786893c96f6671ad4ec160449cc808..f05a99421749a0489ca5407fc43a9f08c6903686 100644 --- a/index.rst +++ b/index.rst @@ -20,4 +20,5 @@ contribute<guides/how-to-contribute-to-this-documentation>`! .. toctree:: :maxdepth: 2 + general/index guides/index