A place to discuss the scrum and agile development environments for technical communicators, designers, and engineers.
Thursday, September 13, 2007
Tools of the trade
I use AuthorIt to single-source my documentation. I find that it helps me to focus my writing. Do you single-source your documentation? If so, do you use AuthorIt or annother application?
I am using Vasont and XMetaL. We were developing for a release, which happens every 6+ months. But now the team is beginning to use some agile development. I'm not sure how these tools fit in with this. Do you generate a full set of documentation each month? How do your reviews work?
I'm thinking of just generating the topics that I work on that month and asking the team to do a shared review using Acrobat 8.
I'm using AuthorIT and Word. I created the full TOC based on the backlog items and requirements. I've been priting out the topics as I finish them and then passing them around for review. I hope this will inspire them to let me know when things change. We are at the end of a sprint for one team and the UI is going to change (probably the 2 days). That means a quick set of screenshots and verifying that the How to... procedures haven't changed. There has to be a better way. This is going to be painful if all of the teams end their sprints on the same week. aarrrgghhh.
This is the place for technical communicators, developers, designers, and usability experts to discuss the agile scrum development environment. Tell us your success and horror stories. Please be courteous and constructive when you comment. Sincerely, Katie Technical Writer and Scrum Team Member
I am a professional technical writer and a perpetual student.
I'm married to my soul mate and we are about to transition to a completely different lifestyle. Join us in the adventure.
2 comments:
I am using Vasont and XMetaL. We were developing for a release, which happens every 6+ months. But now the team is beginning to use some agile development. I'm not sure how these tools fit in with this. Do you generate a full set of documentation each month? How do your reviews work?
I'm thinking of just generating the topics that I work on that month and asking the team to do a shared review using Acrobat 8.
I'm using AuthorIT and Word. I created the full TOC based on the backlog items and requirements.
I've been priting out the topics as I finish them and then passing them around for review. I hope this will inspire them to let me know when things change.
We are at the end of a sprint for one team and the UI is going to change (probably the 2 days). That means a quick set of screenshots and verifying that the How to... procedures haven't changed.
There has to be a better way. This is going to be painful if all of the teams end their sprints on the same week. aarrrgghhh.
Post a Comment