Tagged articles
3 articles
Page 1 of 1
Liangxu Linux
Liangxu Linux
Nov 23, 2024 · Fundamentals

Why Linus Torvalds Insists on Active Voice for Kernel Commit Messages

Linus Torvalds, once notorious for harsh language, now urges Linux kernel contributors to use clear, active‑voice commit messages, explaining the benefits for readability and his own workload while reflecting on his softened tone and recent rc2 release statistics.

Linus TorvaldsLinuxactive voice
0 likes · 7 min read
Why Linus Torvalds Insists on Active Voice for Kernel Commit Messages
ByteFE
ByteFE
Feb 28, 2021 · Fundamentals

What Google Taught Me About Technical Writing

The article shares practical lessons from Google's technical writing course, emphasizing clear, concise, and active‑voice documentation, proper use of pronouns, idioms, lists, and audience‑focused language to help developers produce readable and maintainable technical content.

Documentationactive voiceclarity
0 likes · 12 min read
What Google Taught Me About Technical Writing
ByteFE
ByteFE
Feb 25, 2021 · Fundamentals

Key Lessons from Google’s Technical Writing Course

Google's four‑hour technical writing course teaches essential principles such as clarity, succinctness, proper pronoun use, active voice, effective list formatting, and jargon avoidance, offering practical examples and code‑related illustrations to help developers produce clear, maintainable documentation.

Succinctnessactive voiceclarity
0 likes · 12 min read
Key Lessons from Google’s Technical Writing Course