Hello!

Well, there’s a first time for everything! This is officially my first blog post, and my first time participating in Google Season of Docs - and I couldn’t be more excited!

First, a little about me. 

My name is Cadi and I live in New Zealand, with my husband, on a 42ft yacht. 
You will often find us away from the dock, anchored in a beautiful corner of the Hauraki Gulf.



In my spare time I love sailing (obviously!), hiking (or tramping, as we call it here), mountaineering, painting and travelling (when the world isn’t in the middle of a pandemic, of course). My favourite place in the world is Milford Sound, followed very closely by Disneyland.

I am a pilot by trade, and in the last 10 years I’ve flown everything from 2-seater Cessnas in outback Australia, to the Boeing 737 on international operations. 

So... you might be wondering exactly how I got into technical writing in the first place? 

A few years ago I was asked to rewrite an entire suite of Operating Manuals for the company I was working for. I never considered myself a writer before this - and in fact English was the one subject I dropped as soon as I could in high school - but that was the moment I realised that technical writing combines all the things I enjoy the most. 

It requires problem-solving, attention to detail, and organisation. It requires you to see things from many different perspectives, and asks you to take a walk in someone else’s shoes. Great documentation is a thing of beauty; it can take an ordinary product and make it extraordinary. 

When I found out about the Google Season of Docs programme I knew I had to apply. When I found ScummVM listed on the list of organisations I knew it was the right fit for me; growing up in the 90s those early games were staples of my childhood. 

I’m looking forward to getting to know all of you in this awesome community, and I can’t wait to make some great documentation for a great project. 

Cadi

 

Comments

Post a Comment

Popular posts from this blog

Season of Docs: Project Report - Launch a Documentation Portal

  Project report: Launch a documentation portal •    The original proposal is available  here . •    The finished project, which will remain unchanged, is available  here . •    The live documentation is available  here . •   P ull requests available here  . The objectives The objectives, as set out in the project proposal: 1.    To produce high-quality, versioned end user documentation by consolidating large amounts of information from disparate sources and re-writing information for clarity, consistency, and completeness. Documentation should be easy to understand for beginners, without being patronizing to tech-savvy users. 2.     To create a documentation portal using a static-site generator. 3.    To future-proof end user documentation by creating templates and detailed how-to instructions for future open source contributors. The outcomes The completed documentation portal comfortably meets all the objectives: •    It is easy to follow, easy to navigate and pulls a large amount of
Read more

Season of Docs: Week 7

  What I accomplished during week 7: •  Started an FAQ. It’s got the basics, but I need more! Please keep the questions coming, I’ve only had two responses.... Link to Google Form her e . The FAQ still has formatting issues and definitely some grammar/spelling issues, so don’t judge too harshly (yet).  •  Created an “Other platforms” section, containing port-specific guides according to the agreed structure. I think they work quite well. •  Replaced the GIFs on the iOS page. I’m much happier with how they are now. Feedback on the use of GIFs vs screenshots would be appreciated. •  Added a “Release notes” section.  •  Moved extra information out of the Settings pages and into a new “Guides” section.  •  Got very, very confused by Git. At least now I (kind of) understand how to rebase. I think. Maybe.  I had a meeting with @mataniko this morning, and we discussed how to go about setting minimum requirements for documentation moving forward. It’s been decided that a new “documenta
Read more

Season of Docs: Week 5

  I’ve had a very productive week, now that my personal life has calmed down a bit. I added v2.2.0 information, and finished off the audio and graphics pages. I also created first drafts of the new “saving and loading games” page, as well as contacts, bug reporting, known problems, games notes and copy protection pages.   A catch up with @Mataniko this morning has been very helpful to determine the path forward for the rest of the project, now that the bulk of the information is there. We spoke about what belongs in the documentation, and what doesn’t - and it was decided that things like “Games notes” from the readme, which I experimented with this week, will remain in the wiki, or will be added to the wiki if not there already.  We also spoke about the user experience when navigating the documentation, so for the next week or two I will be tweaking the structure to make sure that the user gets the best possible outcome: Week 6 Re-arranging the docs : •  The settings pages as
Read more