Technical writing with Continuous Integration and docs-as-code
“Surely I’m overthinking this,” I kept saying to myself, impatiently waiting for a solution to appear before my eyes. I learned that it’s tough to create versioned content with a static site generator, while making sure that the source control system does the version tracking and scripts do the build automation and your theme doesn’t […]
“Hoosier,” the somewhat odd name for a native from Indiana, may have its roots in conversation. One of the stories is that when a knock from someone at the door rang out, the person inside would ask, “Who’s here?” and the greeting was shortened to “Hoosier?” Since I grew up in northern Indiana, my memories […]
Lisa Dyer and I have co-authored another paper about structured wikis, using DITA as the structure for the wiki. The paper contains specific ideas about using wikis both internally and externally for software engineering processes and software documentation. Our assertion is this: While either waterfall development methods or Agile development methods could benefit from the […]