This is Mary Connor's Typepad Profile.
Join Typepad and start following Mary Connor's activity
Join Now!
Already a member? Sign In
Mary Connor
Austin, TX
Documentation architect for Agile software development, using any tool and platform that makes sense
Interests: developer documentation, user experience, universal design, software documentation, single-sourcing, process automation, wiki docs, information system design, web-based help and e-learning development, agile and scrum, community-based documentation
Recent Activity
Image
As promised, here is part 3 of my post about publishing using Google Docs; this one deals with how to keep already-published WordPress articles synchronized with source content that lives in Google Docs. GoPublish is the missing piece for syncing... Continue reading
Posted Jul 14, 2023 at Clever Hamster
Technical writers tend to take a dim view of FAQs, those "Frequently Asked Questions" that, in fact, aren't questions. Much criticism of them falls into these categories: Hoarding. You couldn't figure out where to stuff this random bit of information,... Continue reading
Posted Jul 13, 2023 at Clever Hamster
Image
As promised, here is part 2 of my post about publishing using Google Docs; this one deals with how to merge docs into books and deliverables. Document Merge for Google Docs™ is a new Google Suite/Workplace application that allows you... Continue reading
Posted May 19, 2023 at Clever Hamster
Image
We technical writers love shiny, elegant tools to forge our craft, but serving our startups is about supporting what they need right now in a way that is easy for them to maintain, adapt, and afford. To that end, I... Continue reading
Posted Apr 22, 2023 at Clever Hamster
These resources for authoring error messages were just shared on the Write the Docs Slack community, by Monique Semp; they were too good not to save! (On the free plan, our WTD content goes away after a time.) If you're... Continue reading
Posted Apr 19, 2021 at Clever Hamster
As my company was just acquired, I'm turning my attention to our organically developed Agile processes and noticing how it is that we stay so Agile and almost meeting-free. This just happened this morning: While I was busy on a... Continue reading
Posted Jan 26, 2021 at Clever Hamster
Thank you, Stefan! I have considered my own instance, but I see problems with how collaboration would work. As for Viewport, my blocker is that we publish into Jira Service Desk and need to SSO our customers coming in through that portal. Keep me in mind if you need beta testers for anything touching JSD. :-)
Atlassian's abandonment of technical publication and help authoring as a key use case for Confluence is nothing new: 5 years ago they admitted it (CONFCLOUD-2522), and it explains our excruciating experience of being pushed onto a new Cloud editor that... Continue reading
Posted Nov 12, 2020 at Clever Hamster
Image
On the road to a future in cohousing, I have been on a dizzying journey: just this month, I moved to an in-town condo, and in so doing I have literally shed over half of my square footage and three-quarters... Continue reading
Posted May 13, 2019 at Clever Hamster
The ATX Aging & Innovation Summit sold out again, but I'd gotten my ticket in time. This year's focus was "Aging in Community", which aligned perfectly with my interest in innovation in housing, especially cohousing and cooperatives. Highlights for me:... Continue reading
Posted Nov 29, 2018 at Clever Hamster
Now that I'm a member of a cohousing community in development (Ralston Creek Cohousing), folks are asking how I got into it. Truth is, I've been intrigued with the concept of cohousing long before I ever heard the term. Here's... Continue reading
Posted Nov 28, 2018 at Clever Hamster
To delete Confluence spaces quickly, import a dummy Word file to blow away the space contents before attempting the deletion. Continue reading
Posted Jul 25, 2018 at Clever Hamster
This month's Write The Docs ATX meetup featured Ian Buchanan, Senior Developer Advocate at Atlassian: Future-Proof Your Tech Writing Skills with Specification by Example. He was inspired by reading Specification by Example: How Successful Teams Deliver the Right Software (Gojko... Continue reading
Posted Feb 27, 2017 at Clever Hamster
The 4th annual conference for Agile Austin (Keep Austin Agile) was high-energy, plush, and well-attended. The day was a bit of a blur for me, with the excitement of presenting my session and doing interviews, such as for Agile Amped.... Continue reading
Posted Jul 15, 2016 at Clever Hamster
Particularly in Agile shops, it's critical to grab information opportunistically: when that subject matter expert finally comes up for air long enough to discuss that new implementation you've heard was coming, drop everything and grab a basket to catch that... Continue reading
Posted Dec 2, 2015 at Clever Hamster
Oh, happy dance! I've been working in Microsoft Word again (for a content migration project) and I just broke through a major pain point: I figured out how to design style-driven numbered lists that won't go wonky or ever need... Continue reading
Posted Feb 13, 2015 at Clever Hamster
For my own benefit, I'm writing this quick list of goodies and action items from the notes that I jotted down from the Software User Assistance conference this week: Remember "pave the cowpaths" — let users develop footpaths and use... Continue reading
Posted Jan 8, 2015 at Clever Hamster
Image
I'm watching the Acrolinx webinar recording, Learn How CA Technologies Broke the Rules - their DocOps Approach to Agile, with great interest, as it explores the "DocOps" concept in a tangible case study. The presenter is Jim Turcotte, SVP, Business... Continue reading
Posted Dec 17, 2014 at Clever Hamster
Thanks, Jackie! I will definitely dig deeper into options for Chromebook as a work machine. Seems every day I hear about new angles (such as Adobe offering cloud-based use of their tools) that brings that reality closer.
Toggle Commented Nov 1, 2014 on Chromebooks at work? at Clever Hamster
I've been madly in love with my Samsung Chromebook ever since I shamelessly stole it from my early-adopter husband (and I'm not the only one who's done this, I've found). Its tiny price, feather weight, cool operation, and long battery... Continue reading
Posted Oct 8, 2014 at Clever Hamster
Now that more development teams are using Google Docs to develop project artifacts, it's worth looking at optional add-ons that will build out the functionality that we need. One that fills a real need is Letter Feed Workflows for Documents... Continue reading
Posted Jul 10, 2014 at Clever Hamster
Office Labs (yes, that exists!) has come up with a Prezi emulator, what it calls "Plex technology". It's a plug-in to PowerPoint that lets you not only zoom in and out of slide sections but also vault between slides that... Continue reading
Posted Jul 1, 2014 at Clever Hamster
Internal training is a project that often falls onto the shoulders of technical writers, regardless of our instructional design background. Why? Availability and expedience, as it's typical for training resources to be jealously protected for end-user training. (It's the same... Continue reading
Posted Dec 23, 2013 at Clever Hamster
Screenshot rot is a persistent misery for all content production, and it will remain so until we fundamentally automate how we obtain and reference screenshots (tools such as Dr.Explain are trying). It's tempting to avoid screenshot use to escape the... Continue reading
Posted Nov 2, 2013 at Clever Hamster
The challenge: I needed to build internal and external versions of Help from the same source. Putting internal-only information into the Help project itself lets me single-source content and lets staff search across all relevant information, without jumping between sites.... Continue reading
Posted Sep 20, 2013 at Clever Hamster