Your five jobs as a Programmer Writer

On July 1st, I will have been a Programmer Writer at Sitecore for a whole year! It is a fun and challenging job that requires you to switch hats many times during the course of a day. Here are the five jobs you can expect to perform as a Programmer Writer at Sitecore. Scribe There will be a …

Four agile development practices that benefit the documentation

I work with a team of 30+ developers and QA on a large platform. For the most part, I write the documentation by reverse engineering a feature and acting as its first external consumer. This is a good way of sanity checking design and architecture as well as learning how something works. However: Code does not …

Pipe Sphinx Doc build results to text file

I wanted to pipe the results of the Sphinx Doc build into a text file so that I could address any errors or warnings. I started with this (I'm using Windows 8.1): c:\path\to\doc\root>make html > log.txt When I opened the file, there were no errors or warnings listed - and it wasn't because I'm fabulous. It turns …

But I won’t be a developer any more

One month ago, I became Sitecore's first ever Programmer Writer. It is my job to work closely with internal teams as a system or piece of functionality is being built and produce materials for the developers that will eventually use it - documentation, getting started guides, recommended practices, video, blog posts, conference talks, training, sample …