Skip to content

Commit

Permalink
[Australia] Add Workshop page (#2253)
Browse files Browse the repository at this point in the history
* Update menu-mobile.html

* Update menu-desktop.html

* Update australia-2024-sessions.yaml

* Create workshop.rst

* Add time

* Update australia-2024-sessions.yaml

* Fix link issue

---------

Co-authored-by: Swapnil Ogale <[email protected]>
  • Loading branch information
flicstar and swapnilogale authored Nov 7, 2024
1 parent c937515 commit 17ac6c6
Show file tree
Hide file tree
Showing 4 changed files with 68 additions and 1 deletion.
4 changes: 3 additions & 1 deletion docs/_data/australia-2024-sessions.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -256,7 +256,9 @@
<li>Facilitating this workshop</li>
</ul>'
</ul>
<p>Check out the <a href="/conf/australia/2024/workshop/">Brick Docs Workshop</a> page for more detail.</p>'
- title: Don’t make me think - the UX of Developer Experience
slug: don-t-make-me-think-the-ux-of-developer-experience-theresa-neate
series: Write the Docs Australia
Expand Down
3 changes: 3 additions & 0 deletions docs/_templates/2024/menu-desktop.html
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,9 @@
{% endif %}
{% if shortcode == "australia" %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/tales') }}">Tales From the Trenches</a></li>
{% endif %}
{% if shortcode == "australia" %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/workshop') }}">Brick Docs Workshop</a></li>
{% endif %}
{% if flaghashike %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/hike') }}">Hike</a></li>
Expand Down
3 changes: 3 additions & 0 deletions docs/_templates/2024/menu-mobile.html
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,9 @@
{% if shortcode == "australia" %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/tales') }}">Tales From the Trenches</a></li>
{% endif %}
{% if shortcode == "australia" %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/workshop') }}">Brick Docs Workshop</a></li>
{% endif %}
{% if flaghashike %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/hike') }}">Hike</a></li>
{% endif %}
Expand Down
59 changes: 59 additions & 0 deletions docs/conf/australia/2024/workshop.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

Brick Docs Workshop – Build better technical writing skills with LEGO®
======================================================================

Workshop hosts: **Yvonne Perkins and Alexandra Perkins**

Do you work with engineers who find it challenging to write clear, concise, and user-focused technical documentation? Does writing feel like a
stumbling block for your team? The Brick Docs Workshop is designed to address these challenges in a way that’s fun and engaging, using LEGO® bricks as a hands-on tool for learning!

In this one-hour session, we’ll guide participants through practical exercises that show how effective writing can be both achievable and enjoyable.
Brick Docs is a judgment-free learning space where technical writers and engineers can strengthen their skills together, making technical writing accessible and fun for everyone involved.

What to expect
--------------

- Build with LEGO® bricks while learning the essentials of clear communication.
- Learn how to identify and fix common documentation issues.
- Receive instructions and a list of LEGO® bricks needed to run this activity with your own team.

This workshop sharpens critical writing and editing skills, with a special focus on writing documentation that is easy for the user to understand.

This is a safe space: no pressure, no judgments – just a creative and supportive atmosphere.

Schedule
--------

- **Time:** Day 1, Thursday 28 November 2024, 2.10pm.
- **Duration:** 2-hour session with a coffee break in the middle.

- **Workshop time:** The Brick Docs workshop itself takes one hour, designed to fit within the typical time constraints of the average office. We want to make it practical for you to replicate when you get back to work.
- **Follow-up discussion:** After the break, we’ll host an unconference-style chat where participants can share ideas inspired by the workshop and discuss potential applications in their own environments.

- **Materials provided:** All LEGO® bricks and instructions are supplied but you don't get to keep them. All bricks must be returned to the facilitators at the end of the session.
- **Laptop required?** No – just bring your creativity!

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 are welcome.

- **Technical writers** – looking to improve the documentation quality their engineering colleagues produce.
- **Engineers & non-writers** – responsible for creating technical content but who may lack confidence in their writing abilities.

Background
----------

This workshop builds on a successful presentation held at the Write the Docs Melbourne Meetup in May 2024, where interactive sessions like this one have proven highly effective for technical writers working alongside engineering teams in DevOps environments.

Get ready to build better docs!
-------------------------------

Don’t miss this unique opportunity to improve documentation skills in a fun, collaborative way. Join us for Brick Docs, where technical writing meets creativity!

0 comments on commit 17ac6c6

Please sign in to comment.