Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Australia] Add Tales from the Trenches page #2251

Merged
merged 12 commits into from
Nov 6, 2024
3 changes: 3 additions & 0 deletions docs/_templates/2024/menu-desktop.html
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,9 @@
{% if not flagisvirtual %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/sponsor-expo') }}">Sponsor Expo</a></li>
{% endif %}
{% if shortcode == "australia" %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/tales') }}">Tales From the Trenches</a></li>
{% endif %}
{% if flaghashike %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/hike') }}">Hike</a></li>
{% endif %}
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 @@ -17,6 +17,9 @@
{% if not flagisvirtual %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/sponsor-expo') }}">Sponsor Expo</a></li>
{% endif %}
{% if shortcode == "australia" %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/tales') }}">Tales From the Trenches</a></li>
{% endif %}
{% if flaghashike %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/hike') }}">Hike</a></li>
{% endif %}
Expand Down
45 changes: 45 additions & 0 deletions docs/conf/australia/2024/tales.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
:template: {{year}}/generic.html

Tales from the Trenches
=======================

**Where real stories meet tech docs.** This year, Write the Docs Australia is excited to introduce "Tales from the Trenches"—a new initiative inviting attendees to share their unique experiences and offer fresh perspectives.

We’re offering the usual `lightning talks`_ session on Day 1, but with "Tales from the Trenches" on Day 2, we’re setting three broad topics to help spark ideas and focus your stories.

Why join in?
------------

Great things happen when we share what we know. Our community is made up of technical writers, programmers, support teams, developer advocates, content strategists, and more; and we all work in such different spaces—public, private, and open source.

Sometimes the best conversations are the ones that happen in the hallway between sessions. With "Tales from the Trenches," we’re bringing those gems onto the stage for everyone to hear and enjoy.

Who’s it for?
-------------

"Tales from the Trenches" is for everyone\! Whether you’re a natural on stage or this is your first time holding the mic, all are welcome. Some of us have great stories but aren’t sure what’s worth sharing, while others want to speak but don’t know where to start.

This is a relaxed, open space for all of us to share a story or two. We’re all peers here, learning from each other as we go.

How It Works
------------

- **Talks on Day 2**: "Tales from the Trenches" will close out Day 2 with 5-7 minute lightning-style talks—no slides, just you and your story.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe update the schedule entry? And add a note in the lightning talk page?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

YES! I meant to do this and forgot.

- **Pick a topic**: We’ll have three themes to get your ideas flowing.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We already have these themes below right?

- **Sign up**: Add your name to the sheet when you register to claim your spot under a topic. If spots fill up fast, we’ll draw names to keep things fair.

Topics for your tales
---------------------

- **AI in documentation** – What problem did AI ***not*** solve for you? How has AI changed how you work? This could include experiences with AI tools, automation, challenges, and how tech writers are navigating the world of AI.
- **Tech writing fails & documentation horror stories** – We’ve all been there. Whether it’s an embarrassing moment, a big mistake, or just a funny story, we’ve all had fails. Tell us what happened and what you learned\!
flicstar marked this conversation as resolved.
Show resolved Hide resolved
- **Soft skills in technical writing** – What’s a soft skill that’s made a difference in your work? Share stories about resilience, time management, dealing with imposter syndrome, mentoring others, or balancing feedback.

Your five minutes of fame!
--------------------------

Whether it’s a documentation horror story, a tech-writing hack, or a valuable lesson learned, your story matters. Step up, share a tale, and make your mark at the conference\! Plus, by contributing, you’ll be adding to a rich, diverse experience that everyone can learn from.

**Note:** All talks will be recorded and shared on the Write the Docs Australia YouTube channel.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

*Unless you'd rather opt out

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will defo add that in. Thanks.


.. _lightning talks: https://www.writethedocs.org/conf/australia/2024/lightning-talks/