poezio-0.14: update

Signed-off-by: Maxime “pep” Buquet <pep@bouah.net>

content/posts/poezio-0.14.en.md

@@ -42,11 +42,6 @@ improvements such as `xmpp:...?join` URIs handling in `/join`, impromptu rooms
 creation is now more reliable and creates rooms with shorter names. Read more
 [in the changelog][poezio-changelog].
 
-Archive handling ([MAM][XEP-0313]) was already in the previous release, but
-has been reworked and should also be more reliable. Some work around storing
-message IDs -- that our log format doesn't do -- will be needed in the future
-to allow for easier message deduplication.
-
 Plugins have seen changes as well. A new `untrackme` plugin replaces the now
 deprecated `remove_get_trackers`. [Link Mauve][linkmauve] has also developped
 a `sticker` plugin (to send them), similar in essence to what [Movim][movim]
@@ -60,6 +55,28 @@ the best understanding of the project. Thanks also to louiz for providing the
 infrastructure all this time, and to eijebong, Ge0rG, Kaghav Gururajan,
 kaliko, Thomas Hrnciar and southerntofu for the many patches.
 
+# Archiving
+
+Archive handling ([MAM][XEP-0313]) was already in the previous release, but
+has been reworked and should now be more reliable.
+
+When opening a tab, Poezio will fetch 2 screen pages worth of messages if it
+has no logs for this tab. Archives are automatically stored locally if
+configured (default), in which case they won't be redownloaded but read from
+the local copy directly the next time they're requested.
+
+To read older chat messages in a tab, just scroll up with `PageUp` and Poezio
+will fetch more automatically if it needs to.
+
+This is configurable with options that have been introduced such as
+[`mam_sync`][mam_sync] or [`mam_sync_limit`][mam_sync_limit] to enable/disable
+the use of [MAM][XEP-0313] and how many messages to fetch at most. And
+[`use_log`][use_log] also configures the fact that archives are stored
+locally.
+
+Some work around storing message IDs -- that our log format doesn't do -- will
+be needed in the future to allow for easier message deduplication.
+
 # End-to-End Encryption
 
 The Poezio `E2EEPlugin` API has been improved to accommodate changes in
@@ -123,3 +140,7 @@ people to join the effort!
 [XEP-0313]: https://xmpp.org/extensions/xep-0313.html
 [XEP-0384]: https://xmpp.org/extensions/xep-0384.html
 [XEP-0392]: https://xmpp.org/extensions/xep-0392.html
+
+[mam_sync]: https://doc.poez.io/configuration.html#term-mam_sync
+[mam_sync_limit]: https://doc.poez.io/configuration.html#term-mam_sync_limit
+[use_log]: https://doc.poez.io/configuration.html#term-use_log

content/posts/poezio-0.14.fr.md

@@ -46,13 +46,6 @@ quelques-unes, il est maintenant possible d'utiliser des URI comme
 et maintenant plus fiable et ces salons auront des noms plus courts. Vous
 pouvez lire plus [dans le changelog (en)][poezio-changelog].
 
-La gestion de l'archive ([MAM][XEP-0313]) faisait déjà partie de la dernière
-version, mais elle a été retravaillée, et devrait aussi être plus fiable. Du
-travail autour de la gestion des ID de messages -- que notre format de log
-n'enregistre pas -- devra être prévu par la suite pour permettre de
-dédupliquer plus
-facilement les messages.
-
 Les plugins aussi ont été améliorés. Un nouveau plugin `untrackme` remplace
 `remove_get_trackers` qui est maintenant déprecié. [Link Mauve][linkmauve] a
 aussi développé un plugin appelé `sticker` (pour les envoyer), similaire à ce
@@ -67,6 +60,31 @@ Merci aussi à louiz de nous avoir fourni l'infrastructure tout ce temps, et à
 eijebong, Ge0rG, Kaghav Gururajan, kaliko, Thomas Hrnciar et southerntofu pour
 les nombreux patchs.
 
+# Les archives
+
+La gestion de l'archive ([MAM][XEP-0313]) faisait déjà partie de la dernière
+version, mais elle a été retravaillée, et devrait aussi être plus fiable.
+
+En ouvrant une tab, Poezio va télécharger autant de messages nécessaires
+pour remplir 2 pages d'écran, si il n'a aucune archive pour cette tab. Par
+défaut, les archives sont enregistrées automatiquement en local, ce qui permet
+de ne pas re-télécharger les messages la prochaine fois qu'ils sont demandés,
+mais de les lire directement de la copie locale.
+
+Pour lire des messages plus anciens dans une tab, il suffit de scroller avec
+`PageUp` et Poezio se chargera d'aller chercher plus de messages si
+nécéssaire.
+
+Tout ceci est configurable avec des nouvelles options, comme
+[`mam_sync`][mam_sync] ou [`mam_sync_limit`][mam_sync_limit] pour
+activer/désactiver l'utilisation de [MAM][XEP-0313] ou combien de messages
+sont téléchargés au plus. Et aussi [`use_log`][use_log] pour configurer
+l'enregistrement des messages en local.
+
+Du travail autour de la gestion des ID de messages -- que notre format de log
+n'enregistre pas -- devra être prévu par la suite pour permettre de
+dédupliquer plus facilement les messages.
+
 # Chiffrement de bout-à-bout
 
 L'API `E2EEPlugin` de Poezio a été améliorée pour répondre aux besoins des
@@ -139,3 +157,7 @@ personnes intéressées à nous rejoindre !
 [XEP-0313]: https://xmpp.org/extensions/xep-0313.html
 [XEP-0384]: https://xmpp.org/extensions/xep-0384.html
 [XEP-0392]: https://xmpp.org/extensions/xep-0392.html
+
+[mam_sync]: https://doc.poez.io/configuration.html#term-mam_sync
+[mam_sync_limit]: https://doc.poez.io/configuration.html#term-mam_sync_limit
+[use_log]: https://doc.poez.io/configuration.html#term-use_log