-
Notifications
You must be signed in to change notification settings - Fork 499
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[Australia] - added STE workshop page (#2043)
* [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
1 parent
0bb52ee
commit c32444f
Showing
5 changed files
with
74 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |