Writing Technically

---

Guides, blog posts, and courses for technical writers, with the focus being on DITA and on docs as code. Also, the etymology of some words and phrases encountered in techpubs daily life.

Oh, lift me as a wave, a leaf, a cloud!
I fall upon the thorns of life! I bleed!
A heavy weight of hours has chain'd and bow'd
One too like thee: tameless, and swift, and proud.
Make me thy lyre, even as the forest is:
Drive my dead thoughts over the universe
Like wither'd leaves to quicken a new birth!
And, by the incantation of this verse,
Scatter, as from an unextinguish'd hearth
Ashes and sparks, my words ...

-- Percy Byshhe Shelley, Ode to the West Wind

---

• Courses
  • Writing in DITA
• Thoughts
  • DITA without DITA
  • From docs-as-code to DITA
  • Doc debt: Identical files
• Guides
  • Setting up a Sphinx site
  • Adding social media cards to a Sphinx site
  • Adding canonical URLs to a Sphinx site
• Words
  • Content
  • Ephemeral
  • Italics
  • Manager
  • Navigate
  • Swagger
  • Write

---

The things that make this website run are these.

Source filesSite generatorThemeHosting service

`MD` and `RST` files on GitHub

All images on this website, unless specifically acknowledged, are taken from Wikipedia, Wikimedia Commons, or other public sources, or belong to me myself.

---