Commit Graph

12 Commits

Author SHA1 Message Date
Amin Bandali a3d0e1c521 Enable translations (via GNU gettext, sphinx-intl, and transifex)
Change-Id: I4335d5c6e35b8c6dde1643569c13cfdf3572c534
2022-09-15 09:10:41 -04:00
Amin Bandali 162a14046a index: add some info from old wiki home page and drop it
Change-Id: I550550e49365adaed1f0ceaf50c652055417041f
2022-09-12 16:06:30 -04:00
Amin Bandali 2a296411de General cleanup, mainly of links (thanks to sphinx.ext.extlinks)
Add the sphinx.ext.extlinks extension and use it to shorten common
external links, mainly those to Jami's Gerrit and Jami's GitLab.

Also update various other links and references, and change several
remaining occurrences of 'Ring' to 'Jami'.

Lastly, add and use my SVG network topology drawing, which I had
originally drawn for my Jami talk[1] for LibrePlanet 2021.

[1] https://kelar.org/~bandali/talks/jami-empowers-users.html

Change-Id: I58189030b6fafcbed06b81f7b38553eb39494d60
2022-09-08 12:09:54 -04:00
Amin Bandali fd632c2eca Move developer docs from technical/ to developer/ (developer manual)
And standardize their filenames.

Also fix links to internal and external resources (like images, PDFs,
and LibreOffice files).

Change-Id: Ib56898abe5c1244826beee89b260a1bee358a645
2022-07-29 11:07:15 -04:00
Amin Bandali 8aa10d7589 Add misc page for temporarily linking to older wiki pages
This page mainly serves as a jump-in point for the pages of an earlier
version of these documents previously in form of a GitLab wiki.
The ultimate goal/plan for the following pages is to rewrite and/or
reorganize them into the three manuals of Jami: the user manual, the
build manual, and the developer manual.  Thus, the pages linked to
from this page may be moved at any given time.

Change-Id: Iaa4c6ca8cc676a76daa6c3cb30d7772b5ed1a5fc
2022-07-27 15:08:40 -04:00
Amin Bandali 19861c7038 build: start writing the manual, starting with introduction
Change-Id: Iefa04fa4ef450589a6f244bc7915ec018e54e9e1
2022-07-19 08:53:22 -04:00
Amin Bandali a33ae4becc Move contribution guide to top-level and make it general
The idea is for this page to be a jumping point for all kinds of
contributions to Jami, in addition to the docs themselves.

Change-Id: I0f52ee8f0fde9443831886c353baf4d2b649a7d5
2022-07-06 09:32:14 -04:00
Amin Bandali 479da8387f Begin restructuring user docs into a user manual
Change-Id: I36c242f05dbf60234514706eade55d494ee3307d
2022-07-06 09:08:50 -04:00
Sébastien Blin 32640d5c88 Add technical section with up-to-date documentation for swarm
Change-Id: If1e5e95b4f9a128ecce7e800b8e5a0137eb36106
2022-03-17 09:24:34 -05:00
Amin Bandali 9e412ab6cb
Tweak a few links and linkify 'Jami' on the home page
* general/introduction.rst: Drop the extraneous underscore from the
end of the links.
* index.rst: Make the first mention of Jami a link to Jami's website.

Change-Id: I7a3fa301b3bb058a1d39300e2b6cdfcf92a1c178
2022-03-04 09:11:49 -05:00
Amin Bandali ceb761ecbb
Add general introduction to Jami
Co-authored-by: Nick Econopouly <wry@mm.st>
Change-Id: I53dec19a68480133b8dbd2796107d2bb39e0210c
2022-03-03 08:47:23 -05:00
Amin Bandali 882fdab1ed
Initial Sphinx support
Shout out to Nick Econopouly (wrycode) for earlier working demo[1] of
porting the docs from GitLab wiki to Sphinx, which I expect will be
invaluable as we go forward with gradually porting increasingly more
parts of the docs to Sphinx.

[1] https://git.wrycode.com/wrycode/jami-docs/log.html

Change-Id: I5cd7c8142e9639a90df76da887c0f8481e3db405
2022-02-14 11:28:55 -05:00