Skip to content

Commit

Permalink
[Australia] - added STE workshop page (#2043)
Browse files Browse the repository at this point in the history
* [Australia] - added STE workshop page

* Added workshop in menu item

* minor updates to workshop and header image

* fix to schedule for workshop

* minor fix

* revert change

* fudging workshop deets

* fix schedule timings
  • Loading branch information
swapnilogale committed Oct 23, 2023
1 parent 0bb52ee commit c32444f
Show file tree
Hide file tree
Showing 5 changed files with 74 additions and 1 deletion.
2 changes: 1 addition & 1 deletion docs/_data/australia-2023-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ hex: ea6852
time_format: 12h

photos:
default: _static/conf/images/headers/WTDHeader.png
default: _static/conf/images/headers/atlantic-group.png

buttons:
top:
Expand Down
4 changes: 4 additions & 0 deletions docs/_data/australia-2023-schedule.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -36,10 +36,14 @@ talks_day1:
title: Lightning Talks (20 mins)
- duration: '0:05'
title: '5 minute break'
- duration: '0:00'
title: STE Workshop - Part 1
- duration: '1:00'
slug: the-evolving-landscape-of-simplified-english-for-software-documentation-shumin-chen
- duration: '0:20'
title: '☕ Coffee break'
- duration: '0:00'
title: STE Workshop - Part 2
- duration: '0:40'
slug: the-evolving-landscape-of-simplified-english-for-software-documentation-shumin-chen
- duration: '0:05'
Expand Down
5 changes: 5 additions & 0 deletions docs/_templates/2023/menu-desktop.html
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,12 @@
{% endif %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/lightning-talks') }}">Lightning Talks</a></li>
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/unconference') }}">Unconference</a></li>
{% if shortcode == "australia" %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/workshop-ste') }}">STE Workshop</a></li>
{% endif %}
{% if flaghasjobfair %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/job-fair') }}">Sponsor Expo</a></li>
{% endif %}
{% if flaghashike %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/outing') }}">Hike</a></li>
{% endif %}
Expand Down
5 changes: 5 additions & 0 deletions docs/_templates/2023/menu-mobile.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,12 @@
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/welcome-wagon') }}">Welcome Wagon</a></li>
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/lightning-talks') }}">Lightning Talks</a></li>
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/unconference') }}">Unconference</a></li>
{% if shortcode == "australia" %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/workshop-ste') }}">STE Workshop</a></li>
{% endif %}
{% if flaghasjobfair %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/job-fair') }}">Sponsor Expo</a></li>
{% endif %}
{% if flaghaswritingday %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/writing-day') }}">Writing Day</a></li>
{% endif %}
Expand Down
59 changes: 59 additions & 0 deletions docs/conf/australia/2023/workshop-ste.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
:template: {{year}}/generic.html
:banner: _static/conf/images/headers/writing-day.png

Workshop: Simplified English for software documentation
========================================================

Workshop host: **Shumin Chen**

Simplified Technical English (STE) started in the aerospace industry, where it emerged as a solution to address language, communication, and documentation challenges.
While it initially served the defence sector, STE’s inherent versatility and adaptability have made it remarkably relevant and applicable to various industries.

As part of the Write the Docs Australia 2023 conference, we’re running a two-hour workshop on the evolving landscape of Simplified English for software documentation, applying principles and techniques of Simplified Technical English (STE) in the context of the tech industry.
Shumin will show participants how to correctly and effectively use STE in practice. She will also address some of the mistakes commonly found in technical writing and the frequent incorrect use of common STE writing rules.

This workshop explores the evolution of STE from an aerospace standard to its potential in revolutionising documentation practices in the software industry.
By embracing STE, participants will gain insights into how this linguistic paradigm shift can help organisations across diverse sectors enhance clarity, efficiency, and comprehension in their software-related communication.
The flexibility of Simplified Technical English allows for customisation to suit unique requirements. As the specification primarily involves additions to the dictionary, clients themselves often make customisations to cater to different projects within the organisation.

STE has evolved into a versatile language specification capable of transforming documentation practices across various sectors. Its effectiveness in enhancing safety, efficiency, and clarity has made it applicable to industries far beyond its initial scope.
With the power to streamline communication and promote comprehension, STE offers organisations a powerful tool to optimise their technical documentation, regardless of their industry.

**New**: This workshop offers an interactive, discussion-filled approach to picking up basic STE principles that you can already apply to your software documentation.
Everyone at Write the Docs Australia Conference 2023 is welcome to submit a 2-page sample document by 1 December 2023, and we will review and rewrite this for you during the workshop. Email submission: shumin@asd-ste100.net

This unique workshop experience promises to be engaging, interactive, and rigorous. Participants will appreciate how standardise content to

- Author more efficiently
- Maximise consistency
- Facilitate teamwork
- Facilitate translation
- Optimise product lifecycle support
- Reduce the cost of creating and maintaining your documentation

Schedule
--------

- Date & Time: **Thursday, 7th December 2023, 2.10pm-4.10pm**.
- Location: **Melbourne, Australia**. Find out more: :doc:`/conf/australia/2023/venue`

Prerequisites
-------------

During the workshop we will review, edit, and discuss participants’ own documents to reinforce learning. So, bring a laptop with WiFi and editing capabilities if you can.

Cost (none)
-----------

The workshop fee is included in your conference admission.
There is no extra charge for the workshop.

Who's welcome
-------------

All conference participants with a budding curiosity about STE are cordially invited! This workshop is designed for technical writers who want to communicate most effectively with a global audience.
The workshop content is intended for technical writers but is also greatly relevant for technical enablement managers, instructional designers, training content developers, knowledge managers, team leaders, and anyone intrigued by the idea of using a controlled English vocabulary to enhance the technical communication experience.

Seasoned technical writers are certain to find the content engaging, offering a fresh perspective on the often-controversial nature of the technical English language.
The workshop adopts a highly interactive and entertaining format, encouraging participants to engage in lively debates while applying the principles presented.
The material is deliberately structured to spark thought-provoking discussions.

0 comments on commit c32444f

Please sign in to comment.