Ce guide compile des conseils et des idées sur l'écriture technique, en particulier pour la technologie Web et les blogs, tirant de professionnels expérimentés et d'expérience personnelle.

Choisir votre sujet:

Le sujet idéal est celui qui vous passionne et que vous investissez personnellement. Votre enthousiasme va traverser. Comme Chris Coyier le conseille judicieusement: "écrivez l'article que vous souhaitez trouver lorsque vous avez googlé quelque chose." Bien que l'écriture basée sur les affectations puisse être productive, la connexion personnelle élève la qualité.

écrivez pendant que les connaissances sont fra?ches:

Le meilleur moment pour écrire est immédiatement après avoir appris quelque chose de nouveau. L'expérience est encore vive, vous permettant de transmettre les "avant" et "après" de compréhension. Même noter les notes rapides sur votre processus d'apprentissage peut être utile plus tard. Considérez l'approche ?aujourd'hui que j'ai apprise? (jusqu'à ce que

Comparaison de levier:

Une technique puissante et sous-utilisée consiste à comparer les nouvelles technologies à celles familières. Rachel Andrew suggère d'expliquer les techniques de javascript modernes à quelqu'un qui conna?t jQuery, combler l'écart entre le nouveau et le connu. Cette approche relie l'inconnu à une fondation bien compris.

Créant une introduction convaincante:

Un écueil commun ne parvient pas à indiquer clairement le but de l'article et à cibler le public dès le début. Rachel Andrew souligne l'importance d'une introduction concise qui clarifie immédiatement le sujet et le lectorat prévu. Brian Rinaldi ajoute qu'un paragraphe d'introduction bien écrit peut déterminer si un lecteur se poursuit.

Titres clairs et concis:

Erin Kissane plaide pour des titres clairs et descriptifs, la priorisation de la clarté sur Clickbait. Un titre clair comme "Mise en route avec GraphQL, Phoenix et React" est bien supérieur à un vague et clickbaity. La clarté profite à la fois à la compréhension des lecteurs et au référencement.

L'art de l'oundro:

Ben Halpern souligne l'importance du paragraphe de conclusion, souvent la deuxième section la plus lue après l'introduction. Alors qu'un simple résumé ("Dites-leur ce que vous leur dit") est efficace, une conclusion bien con?ue renforce le message et fournit la fermeture.

Amélioration de la numérabilité:

Brian Rinaldi souligne l'importance de briser de grands blocs de texte pour améliorer la lisibilité. Les techniques incluent l'utilisation des sous-titres, des listes, des images et des captures d'écran pertinentes, des graphiques illustratifs, des vidéos concises, des blocs de code bien formés, des tables et des sections pliables à l'aide <details>/<summary></summary></details> . L'utilisation stratégique d'éléments de conception tels que l'espacement, la couleur et l'alignement améliorent encore la scannabilité.

Choix de voix et de mots actifs:

Katy Decorah et Neal Whitman soulignent l'importance d'utiliser une voix active ("le serveur traite la demande") au lieu d'une voix passive ("La demande est traitée par le serveur"). évitez des mots comme ?juste?, qui peuvent être condescendants et souvent inutiles.

Maintenir le ton et la voix:

Le ton (comment vous dites quelque chose) devrait s'aligner sur le contexte. Un ton amical, faisant autorité, accueillant et reconnaissant est généralement adapté à la rédaction technique. La voix (votre personnalité) doit rester cohérente, même en ajustant le ton pour différentes situations.

Gestion de la durée:

L'écriture technique souffre souvent d'une longueur excessive. Wade Christensen recommande une approche d'édition impitoyable. Bien que les poteaux excessivement courts soient également problématiques, la clarté et l'utilité devraient être l'objectif principal, pas le nombre de mots. La rupture d'un long poteau en série ne doit être effectuée que si les pièces sont thématiques et autonomes.

Surmonter le bloc de l'écrivain:

La peur et le doute de soi sont des obstacles communs aux blogs techniques. Max B?ck suggère de publier dès que les points essentiels sont couverts, ignorant la voix "ce n'est pas prêt". Jeremy Keith conseille de garder les ébauches, car ils restent souvent inachevés. N'oubliez pas que même une petite contribution peut être utile (Matthias Ott). Ali Spittel souligne que même les débutants ont des perspectives précieuses.

Style et créativité:

Sara Soueidan souligne qu'il n'y a pas de style d'écriture parfait. Soyez vous-même et laissez votre personnalité briller tout en maintenant la clarté. Expérimentez avec des formats créatifs, comme des conversations annotées ou des séries vidéo.

Contenu axé sur les débutants:

Bien que le Web soit rempli de contenu de niveau débutant, un article d'introduction bien écrit peut se démarquer. La clarté est précieuse pour tous les niveaux de compétence.

Exemples du monde réel par rapport à l'abstraction:

Christine souligne l'importance des exemples du monde réel pour illustrer des concepts complexes. Cependant, évitez les exemples qui compromettent la clarté. L'abstraction peut être puissante lorsqu'elle est utilisée efficacement.

Les avantages du blog:

Les blogs améliorent les perspectives de carrière, démontrent l'expertise et améliore la compréhension. Khoi Vinh décrit les blogs comme un ?amplificateur?.

Pratique et amélioration:

L'écriture et l'édition cohérentes sont cruciales pour l'amélioration. "écrire avec des enjeux" (partager publiquement votre travail) est la méthode d'apprentissage la plus efficace.

Trouver votre voix:

Commencez par partager simplement vos connaissances. Améliorez votre écriture en incorporant des expériences personnelles, en citant les autres et en effectuant des recherches.

Publication d'invité:

Si vous lancez sur un site, passez soigneusement leurs directives.

Outils utiles:

Le papier Dropbox pour la collaboration et grammaire pour la relecture sont des outils suggérés.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!