Skip to content

docs(moderation): restructure and complete the moderation page - #17

Open
hboisgibault wants to merge 1 commit into
masterfrom
docs/improve-moderation-page
Open

docs(moderation): restructure and complete the moderation page#17
hboisgibault wants to merge 1 commit into
masterfrom
docs/improve-moderation-page

Conversation

@hboisgibault

Copy link
Copy Markdown
Collaborator

Objectif

Mise à jour et complétion de la page Modération, qui n'avait pas été retravaillée depuis novembre 2024.

Changements

Page française (docs/configuration/moderation.md)

  • Restructuration : séparation claire entre le type de modération (a priori / a posteriori) et le responsable de la modération (manuelle / intelligente Logora / externe), chacun dans sa propre section avec les défauts recommandés mis en évidence.
  • Corrections : typos et espacement (« Avant publication du contenu`- », « envoyez nous » → « envoyez-nous »), accords grammaticaux, coquilles (« contributions » / « contenants »).
  • Contenu nouveau :
    • comportement des contributions rejetées (visibles par l'auteur uniquement, modifiables et renvoyables) ;
    • section Fonctionnement de la modération : flux de modération, part automatisée (80-85 %) vs manuelle, et explication du score de modération ;
    • section Interface de modération avec la capture d'écran existante (/img/moderationtab.png, présente dans le dépôt mais jamais référencée) ;
    • section Pour aller plus loin avec des liens vers les pages Qualité des contenus, Modération des réseaux sociaux et RGPD ;
    • e-mail de contact cliquable.
  • Les seules informations factuelles (45 000 contributions labellisées, 15-20 % de modération manuelle, modération toutes les 24h en semaine, deux millions d'arguments traités) sont reprises à l'identique de la version précédente — rien n'a été inventé.

Traduction anglaise (i18n/en/.../moderation.md)

  • La traduction anglaise était tronquée au milieu d'une phrase (« Once the argum ») et ne couvrait ni les types de modération ni les responsables. Elle est maintenant complète et alignée sur la structure française.

Validation

  • docusaurus build exécuté localement : les deux pages (/configuration/moderation et /en/configuration/moderation) sont générées, tous les nouveaux liens se résolvent en FR et EN. Le build signale uniquement deux liens cassés préexistants dans d'autres pages anglaises (/en/configuration/routes, /en/installation/webview), hors du périmètre de cette PR.

Notes pour la review

  • Vérifiez notamment les formulations métier : « score de modération » (score bas = accepté automatiquement / score haut = analyse humaine), et la phrase sur la modération sous-traitée aux prestataires externes.

- fix typos and spacing (a priori/a posteriori wording, 'envoyez-nous')
- restructure: settings overview, type of moderation, moderation owner
  (manual / smart / external) with recommended defaults
- document rejected-contributions behavior (visible to author, editable)
- add moderation process and scoring explanation
- add moderation interface section with existing screenshot
- add related-pages section (quality, social moderation, RGPD) and
  contact email
- complete the truncated English translation and mirror the new
  structure
@hboisgibault

Copy link
Copy Markdown
Collaborator Author

🤖 OpenHands est en train de revoir cette PR.

Commit head : 9a6ef2da1a60856318f5fb45eae6246a68716eb9
Voir la conversation : https://agent.logora.com/conversations/23be2f53-8725-4120-90cf-0d4be4e942a8

Ce message a été posté par un agent IA (OpenHands).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants