La plate-forme Open edX est vaste et puissante, avec de nombreuses options pour les opérateurs. Ces options sont souvent sélectionnables à l'aide de commutateurs au niveau du code appelés bascules ou paramètres de configuration. Nous n'avons pas toujours fait un bon travail de documentation de ces options, laissant certains opérateurs se gratter la tête sur leur signification ou leurs implications. Cette année, à l'occasion de la Journée internationale de l'éducation (24 janvier) et pour faciliter l'utilisation de la plateforme Open edX afin de contribuer à l'éducation de tous, partout, la communauté Open edX a organisé une Doc-a-thon pour documenter les bascules et les paramètres de la plate-forme.
Le doc-a-thon nous a donné un bon départ pour ranger et clarifier ces options. Nous sommes très reconnaissants à tous ceux qui ont contribué à rendre la plateforme plus utilisable pour tous.
Initialement, il devait se dérouler du 25 au 29 janvier, mais il a connu un tel succès que la communauté Open edX l'a prolongé jusqu'au 15 mars.
Nous sommes ravis des résultats - 104 bascules et paramètres ont été documentés. Cela signifie 30 % de toutes les bascules dans la plate-forme ont maintenant de la documentation. Vous pouvez voir le résultat dans notre bascule et paramètres référence technique. Cet effort a tiré parti de l'infrastructure de documentation des bascules et des paramètres qui a été construite par Surplomb.io en tant que projet de développement mixte.
Un grand merci au 17 auteurs de la communauté Open edX, qui a contribué à la documentation, – Gonzalo Romero, Renard Piacenti, Luis Moreno, Régis Behmo, Robert Raposa, Raúl Gallegos, Philippe Montoya, Johnny Avella, anjalia28, Gabor Boros, Saqib, Sofiane Bébert, Zia Fazal, Pierre Pince et Arslan Achraf. Braden MacDonald et Peter a tiré parti de leur auteur principal droit de fusionner les contributions.
Félicitations et remerciements particuliers à nos meilleurs contributeurs :
- un merci spécial aux deux meilleurs contributeurs de code - JayRam Nai et Agréable, dont les travaux combinés représentent près de 40 % de tous les PR ouverts pendant le doc-a-thon.
- meilleur critique de relations publiques de la communauté : Raúl Gallegos!
Nous sommes ravis de permettre et d'encourager toutes sortes de contributions au monde Open edX. Le doc-a-thon était un bon exemple d'un nouveau style de contribution : des pièces plus petites plus faciles à atterrir. La contribution ne signifie pas nécessairement mettre en œuvre des fonctionnalités de tête d'affiche ou résoudre des problèmes techniques épineux. Toutes sortes de compétences, d'intérêts et de niveaux d'énergie peuvent faire la différence.
Merci à tous d'avoir contribué à l'amélioration de la plateforme !
![]()