Cameron Shorter

Thoughts on maps, clean energy & docs, sometimes with an Australian accent.

Sunday, 9 February 2025

Finding Hidden Gems in Collaborative Communities

›
How do you, As a community leader, Recognize ‘hidden gems’ in a community, and Attract them to collaborate with you? ...
Monday, 2 December 2024

Mastering doc reviews

›
Great doc reviews go beyond reviewing doc quality. It additionally assesses the author’s assessment of their writing ability. We can then ri...
Saturday, 8 June 2024

Commenting guide for collaborative document reviews

›
After thousands of collaborative documentation reviews, from our Good Docs Project technical writers, we have established a bunch of practi...
Friday, 10 May 2024

Solar panels use 66% of the land required to generate and deliver coal power

›
 At 5c per kWh, we know that Australian solar generates the cheapest energy in the world, but how does it stack up against coal when compari...
Monday, 25 September 2023

Electrifying friends

›
It’s surprising to discover the knock-on impact each of us has when we become that trusted friend who helps people or communities with their...
Tuesday, 6 June 2023

Gitlab's conversation with The Good Docs Project

›
The Good Docs Project has been inducted as a  GitLab open source project partner , and Bryan Behrenshausen from GitLab interviewed us about...
Saturday, 27 May 2023

Time to retire Contributor License Agreements

›
Imposing Contributor License Agreements (CLAs) on open source contributors inadvertently imposes unnecessary legal risk on the people gifti...
Thursday, 25 May 2023

Open Source awards for Good Docs contributors

›
Congratulations to Google's Open Source Peer Bonus award winners. Winners from The Good Docs Project include: Ophy Ampoh Ophy Ampoh is...
Wednesday, 24 May 2023

Keystone Project - The Good Docs Project

›
The Good Docs Project is growing into a keystone project for software ecosystems. What’s a Keystone Project? In architecture, a mason...
Saturday, 4 March 2023

Signing off from Google

›
It's been a great three years at Google. So many opportunities to do something meaningful, to learn, to be impactful. Chromebook require...
Friday, 2 December 2022

Meet a Google Tech Writer

›
Yep, I'm one of the profiled Google tech writers : Cameron's story I was surprised to wake one morning and realize I’d become a writ...
Friday, 21 October 2022

Requirement writing

›
  "When [condition] the [device] MUST [do something]." It's surprising how many ways we can get this pattern wrong. This prese...
Tuesday, 4 October 2022

Open Source awards for Good Docs contributors

›
Congratulations to Google's Open Source Peer Bonus award winners. Winners from The Good Docs Project include: Felicity Brand Felicity ...
Friday, 30 September 2022

When to call in us tech writers

›
In a knowledge economy, effectiveness depends upon transferring ideas between people. Technical writing is the art of optimizing the communi...
Monday, 18 April 2022

Open Source Peer Bonuses for Good Doc Templateers

›
 Congratulations to five templatateers from The Good Docs Project for your  Open Source Peer Bonus award  from Google.  This cool award ena...

Curly Beach to Forestway by bicycle

›
Cycle from Curl Curl beach back to Forestway via bike paths, back streets, and a short stretch of dirt trail. 10 kms. 30 mins. Enjoy the jou...
Wednesday, 26 January 2022

My Open Source Docs addiction

›
  Why am I addicted to open source docs? "Giving back" adds extra meaning and purpose to my life. It's impactful. I can tackle...
Saturday, 15 January 2022

Frenchs Forest to Warringah Mall by bicycle

›
Want a quick, 20 minute, pleasant and safe bicycle route from Frenchs Forest down to Warringah Mall? Try this:  Cycle from Frenchs Forest do...
Friday, 17 December 2021

Defining good

›
Within non-trivial technical projects, it helps to have a common language to describe "good": It enables cross-feature comparison...
Sunday, 19 September 2021

Open source peer bonuses

›
  Congratulations Alyssa, Angelos and Aiden for your  Google's Open Source Peer Bonus award .  This cool award enables Google employees ...

Timeless documentation

›
Big Ben clock Maintaining docs for an evolving software baseline is a constant pain for us technical writers. I'm often helping develope...
Tuesday, 20 April 2021

Walk your bike into the car park!

›
TS;DR (Too Sarky; Don't Read) I've been riding to work for around 30 years, and every year or two you see an email such as this, and...
Monday, 8 March 2021

Doc templates workshop

›
The Good Docs Project is about to run a series of one hour workshops to brainstorm: What constitutes a good doctype template? How sh...
Thursday, 4 March 2021

Open Source Documentation Panel - Contributing.today

›
  I joined a panel at Contributing Today  talking about open source documentation with: Scott Riley, product designer  Gitbook , author of M...
Saturday, 6 February 2021

Tweak Google's mission?

›
Google has an awesome mission statement: "To organize the world's information and make it universally accessible and useful." ...
Friday, 1 January 2021

Cycle Manly to Frenchs Forest

›
Here is a beautiful ride from Manly to Frenchs Forest using only quiet backstreets, cycle paths, tracks and fire-trails. Cycle Manly to Fren...
Thursday, 3 December 2020

State of The Good Docs Project

›
Lightning talk summarizing the status of initiatives within The Good Docs Project . Presented at Write The Docs - Australia and India. Sourc...
Wednesday, 2 December 2020

Halfway status - glossary pilot

›
This interim status report outlines achievements, early findings and outstanding tasks for our cross-organizational glossary pilot project ...
›
Home
View web version
Powered by Blogger.