Who should take this course? Anyone in the community who wants to improve their technical writing skills. If you are a software engineer, a computer science student, or have an engineering-adjacent role (such as product manager), then this course are for you! No registration is necessary.
@jwnasambu, no need to register! And if you can’t make today’s session (like me), there’s another one in a couple of weeks. It’s great that there are also pre-class materials that we can do on our own time, before the class.
That was a good session. They paired us up with a partner and we practiced a number of scenarios.
@gracebish it was nice to see you on the call at the same time (the 2 Graces representing!) - what did you think of it?
Resources Discovered
@jennifer - after the teaching session they had a small Q&A session. I explained OpenMRS & our Tech Writing / Documentation team. Nicola Yap offered to help answer our questions any time; she was one of the main facilitators and is a technical writer at Google.
Nicola also recommended we follow the Slack group for Write the Docs, which has a 12,000+ membership of technical writers. I think one of our GSOC students had mentioned this as well but it fell off my radar. Their slack group actually has a specific channel for #community-help-wanted
I got to work with a software engineer from Splunk working on Kubernetes. For example, one of the assignments we worked through was to summarize the project you’re working on in language the the partner could understand. Here’s what he wrote about Kubernetes, I found this nice for someone at my level:
…
"Kubernetes is a popular open source technology for orchestrating containers. Key benefits of using Kubernetes include:
Simplified deployment and lifecycle management of containerized applications
Consistent interface for software developers to build applications
Ease of scaling the application when the load grows
An example of this simplification is that when running on Kubernetes, the developer need not worry about which Operating System is being used or which machine it is running on.
Kubernetes is like a maestro in the symphony, managing different resources in the system seamlessly and providing harmonious output."
…
You can see how we were practicing shorter sentences and lists.
@grace it was such a blessing to me to participate. This should be promoted to other members as well. The lessons are very practical, thanks to Google.
Thanks to @jwnasambu, @isamanya, @dkayiwa and other members who made time to attend. I believe we shall have such a vibrant documentation team this year.