Introduction

Pourquoi cette rubrique ?¶

Vers la fin de 2024, il est devenu évident que tous les articles contenus dans la documentation de Rocky Linux ne seront pas des guides pratiques. Nous avions besoin d’un endroit pour des explications plus détaillées. Accédez à ce blog.

Qui peut écrire ici ?¶

Toute personne disposant d’un compte GitHub peut proposer un article ici. Consultez les documents dans la section Contribuer pour commencer.

Si vous n'avez pas d'identifiants GitHub et que vous souhaitez quand même écrire quelque chose pour cette section, contactez-nous via le lien du canal Mattermost au bas de cette page.

Vous devez vous assurer que votre document répond aux exigences de cette section. Par exemple :

• Est-ce que ça convient ici ? Est-ce que cette information mérite d’être partagée ? S'agit-il d'un document de type blog ?
• Est-ce que cela traite d'un sujet important pour les documentaristes ?
• La publication améliorera-t-elle la qualité globale de toute la documentation de Rocky Linux ?

Quel genre d'informations ?¶

Les deux premiers documents ici devraient vous donner une idée de ce qui correspond. Tout au long de l’année 2024, nous avons déployé des efforts concertés pour éliminer ou réduire considérablement la voix passive dans les documents pratiques. Le document [Voix active : vers une communication simple et claire] (active_voice.md) décrit l'importance de la voix active dans le ton de la documentation, la facilité de lecture et de compréhension, et la simplification de la traduction vers d'autres langues. Le document Open source : Pourquoi sans trait d'union discute du débat sur ce sujet et des raisons pour justifier notre décision de ne pas utiliser de trait d'union. Vous comprenez l’idée ? Il s’agit de documents informatifs qui n’incluent pas d’informations pratiques, sauf peut-être à titre d’exemples.

La croissance de ce blog ?¶

On s’attend à ce que cet ensemble de documents se développe plus lentement que les guides pratiques. C'est tout à fait normal. C'est la qualité et la pertinence des documents qui sont ici essentielles.

Feedback¶

Tout comme pour la documentation dans son ensemble, vous pouvez donner votre avis sur notre canal Documentation Mattermost.

Author: Steven Spencer