Skip to content

Commit

Permalink
Merge branch 'main' into q4-2024-community-blog
Browse files Browse the repository at this point in the history
  • Loading branch information
thatdocslady committed Nov 22, 2024
2 parents 02e46fd + 86b064a commit 93b1cdd
Show file tree
Hide file tree
Showing 14 changed files with 181 additions and 89 deletions.
24 changes: 20 additions & 4 deletions docs/_data/australia-2024-schedule.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,16 @@ talks_day1:
slug: don-t-make-me-think-the-ux-of-developer-experience-theresa-neate
- duration: '0:10'
title: '✋ 10 min Q&A'
- duration: '0:05'
title: '5 minute break'
- duration: '0:20'
title: '☕ Coffee break'
- duration: '0:00'
title: "<b>Unconference Starts</b>"
- duration: '0:30'
slug: naming-guidelines-so-many-naming-guidelines-jay-stephens
- duration: '0:10'
title: '✋ 10 min Q&A'
- duration: '0:20'
title: '☕ Coffee break'
- duration: '0:05'
title: '5 minute break'
- duration: '0:30'
slug: what-if-we-just-got-ai-to-write-the-docs-lana-brindley-she-her
- duration: '0:10'
Expand All @@ -28,12 +30,16 @@ talks_day1:
slug: global-voices-inclusive-docs-how-open-source-sets-the-standard-for-inclusivity-eeshaan-sawant
- duration: '0:10'
title: '✋ 10 min Q&A'
- duration: '0:00'
title: "<b>Unconference Ends</b>"
- duration: '1:00'
title: '🍽️ Lunch Break (60 mins)'
- duration: '0:20'
title: Lightning Talks (20 mins)
- duration: '0:05'
title: '5 minute break'
- duration: '0:00'
title: "<b>Unconference Starts</b>"
- duration: '0:00'
title: Brick Docs Workshop - Part 1
- duration: '1:00'
Expand All @@ -44,6 +50,8 @@ talks_day1:
title: Brick Docs Workshop - Part 2
- duration: '0:40'
slug: brick-docs-workshop-yvonne-perkins
- duration: '0:00'
title: "<b>Unconference Ends</b>"
- duration: '0:05'
title: '<b>Group Photo!</b>'
- duration: '0:00'
Expand All @@ -63,6 +71,8 @@ talks_day2:
title: '✋ 10 min Q&A'
- duration: '0:20'
title: '☕ Coffee break'
- duration: '0:00'
title: "<b>Unconference Starts</b>"
- duration: '0:30'
slug: where-journalism-and-advertising-writing-skills-overlap-with-technical-writing-justine-stewart
- duration: '0:10'
Expand All @@ -73,8 +83,12 @@ talks_day2:
slug: how-we-improved-qualitative-feedback-in-our-documentation-austin-lai
- duration: '0:10'
title: '✋ 10 min Q&A'
- duration: '0:00'
title: "<b>Unconference Ends</b>"
- duration: '1:00'
title: '🍽️ Lunch Break (60 mins)'
- duration: '0:00'
title: "<b>Unconference Starts</b>"
- duration: '0:30'
slug: snack-videos-for-your-audience-ruth
- duration: '0:10'
Expand All @@ -85,6 +99,8 @@ talks_day2:
slug: tips-for-great-review-comments-cameron-shorter
- duration: '0:10'
title: '✋ 10 min Q&A'
- duration: '0:00'
title: "<b>Unconference Ends</b>"
- duration: '0:25'
title: '☕ Coffee break'
- duration: '0:45'
Expand Down
10 changes: 5 additions & 5 deletions docs/_data/portland-2025-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -99,23 +99,23 @@ date: # how do we handle these? human readable would be nice.

# Conference is special for the index to show the combined conference days
conference:
event: Speaker talks
event: Speaker Talks
date: May 5-6
summary: The main days of the conference. Listen to a diverse panel of speakers share their insights and experience. See our <a href="https://www.writethedocs.org/conf/portland/2025/speakers/">full list of speakers</a>.
summary: The main days of the conference. Listen to a diverse panel of speakers share their insights and experience.
icon: conference

# These are listed in the schedule
day_one:
event: Hike
date: May 3
# summary: We encourage you to go on a hike in your own beautiful home town.
summary: If you're in town early, join us for the <a href="/conf/portland/2025/hike/">Hike</a>. Portland has excellent access to the woods right in the city.
summary: If you're in town early, join us for the Hike. Portland has excellent access to the woods right in the city.
icon: hike
dotw: Saturday
day_two:
event: Writing Day & Reception
event: Writing Day
date: May 4
summary: Kick off the conference with <a href="/conf/portland/2025/writing-day/">Writing Day</a> and work with fellow documentarians on a project. Followed by the opening reception.
summary: Kick off the conference with Writing Day and work with fellow documentarians on a project. Followed by the opening reception.
icon: writing
dotw: Sunday
writing_day_time: 9am-5pm
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_static/conf/images/pics/reg.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_static/conf/images/pics/writing-day.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/_templates/2025/base.html
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ <h2 class="uk-first-column"><a href="/conf/{{ shortcode }}/{{ year }}/sponsors/"
</ul>

</div><!-- end of footer content -->
<div class="footer-pics">
{# <div class="footer-pics">
<div>
<img src="{{ pathto('_static/conf/images/pics/ft-image-01.jpg', 1) }}" alt="" >
</div>
Expand All @@ -131,7 +131,7 @@ <h2 class="uk-first-column"><a href="/conf/{{ shortcode }}/{{ year }}/sponsors/"
<div>
<img src="{{ pathto('_static/conf/images/pics/ft-image-03.jpg', 1) }}" alt="" >
</div>
</div>
</div> #}
</div>
</footer><!-- end footer -->

Expand Down
94 changes: 43 additions & 51 deletions docs/_templates/2025/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -113,47 +113,44 @@
<div class="uk-container">

<div class="about-content">
<h2>What is Write the Docs?</h2>
<p>
Write the Docs is a global community of people who care
about documentation: Programmers, Tech Writers,
Customer Support, Designers, Project Managers,
Developer Advocates, and anyone else who wants people
to have a great experience with software.
</p>
<p>
Created in 2013 in Portland, Oregon, WTD has hosted
conferences around the world in Prague, Sydney,
Amsterdam, London, and Melbourne.
</p>
<h2>What is Write the Docs?</h2>
<p>
Write the Docs is a global community of people who care
about documentation: Programmers, Tech Writers,
Customer Support, Designers, Project Managers,
Developer Advocates, and anyone else who wants people
to have a great experience with software.
</p>
<p>
Created in 2013 in Portland, Oregon, WTD has hosted
conferences around the world in Prague, Sydney,
Amsterdam, London, and Melbourne.
</p>
<p>
We invite you to our {{ name }} conference to join {{ about.attendees }}
other attendees to explore the art and science of
documentation!

{% if flagticketsonsale %}
<strong><a href="/conf/{{shortcode}}/{{year}}/tickets/">Tickets</a> are on sale now</strong>.
{% endif %}
</p>

{% if flagcfp %}
<p>
We invite you to our {{ name }} conference to join {{ about.attendees }}
other attendees to explore the art and science of
documentation!
{% if flagticketsonsale %}
<strong><a href="/conf/{{shortcode}}/{{year}}/tickets/">Tickets</a> are on sale now</strong>.
{% endif %}
Interested in being a speaker? We’re accepting
<a href="/conf/{{shortcode}}/{{year}}/cfp/">Call for Proposals</a> until {{ cfp.ends }}.
</p>
{% if flagcfp %}
<p>
Interested in being a speaker? We’re accepting
<a href="/conf/{{shortcode}}/{{year}}/cfp/">Call for Proposals</a> until {{ cfp.ends }}.
</p>
{% endif %}
{% endif %}

</div>

<div class="picture-set">
<div data-aos="pictrue-03" data-aos-once="true">
<img src="{{ pathto('_static/conf/images/pics/pictrue-03.jpg', 1) }}" alt="" >
</div>
<div data-aos="pictrue-02" data-aos-once="true">
<img src="{{ pathto('_static/conf/images/pics/pictrue-02.jpg', 1) }}" alt="" >
</div>
<div data-aos="pictrue-01" data-aos-once="true">
<img src="{{ pathto('_static/conf/images/pics/pictrue-01.jpg', 1) }}" alt="" >
</div>
<div class="picture-set" style="max-width: 45%; padding: 5px;">
<span style="padding: 5px; display: flex; align-items: center; justify-content: center; height: 100%;">
<img src="{{ pathto('_static/conf/images/pics/writing-day.jpg', 1) }}" alt="Group photo" style="padding: 25px;">
</span>
</div>

</div>
</div><!-- end about -->

Expand Down Expand Up @@ -193,7 +190,7 @@ <h3>{{ date.conference.event }} </h3>
<img style="height: 150px;" src="{{ pathto('_static/conf/images/icons/conversation' + '-' + color + '.svg', 1) }}" alt="" >
<h3>Unconference</h3>
<em>{{ date.conference.date }}</em>
<p>Share ideas, solve problems and participate in discussions. Anyone can suggest, lead and attend an <a href="/conf/{{shortcode}}/{{year}}/unconference/">Unconference</a>.</p>
<p>Share ideas, solve problems and participate in discussions. Anyone can suggest, lead and attend an Unconference.</p>
</div>

{% endif %}
Expand All @@ -205,7 +202,7 @@ <h3>Unconference</h3>
<img style="height: 150px;" src="{{ pathto('_static/conf/images/icons/lightning' + '-' + color + '.svg', 1) }}"" alt="" >
<h3>Lightning Talks</h3>
<em>{{ date.conference.date }} </em>
<p>A <a href="/conf/{{shortcode}}/{{year}}/lightning-talks/">Lightning Talk</a> is a short talk where you share an idea or concept. Great for first time speakers, sign ups occur on-site.</p>
<p>A Lightning Talk is a short talk where you share an idea or concept. Great for first time speakers, sign ups happen on-site.</p>
</div>

{% endif %}
Expand All @@ -215,9 +212,9 @@ <h3>Lightning Talks</h3>

<div class="schedule-item uk-width-1-{{ 1 + date.total_talk_days }}@s">
<img style="height: 150px;" src="{{ pathto('_static/conf/images/icons/sponsor-expo' + '-' + color + '.svg', 1) }}"" alt="" >
<h3>Sponsor Booths</h3>
<h3>Sponsor Expo</h3>
<em>{{ date.conference.date }}</em>
<p>Engage with our <a href="/conf/{{shortcode}}/{{year}}/sponsors/">Sponsors</a>, discuss job opportunities and interact with new products.</p>
<p>Engage with our sponsors, discuss job opportunities and interact with new products.</p>
</div>

{% endif %}
Expand All @@ -237,6 +234,13 @@ <h3>Sponsor Booths</h3>
<div class="about" id="about">
<div class="uk-container">

<div class="picture-set" style="max-width: 45%; padding: 5px;">
<span style="padding: 5px; display: flex; align-items: center; justify-content: center; height: 100%;">
<img src="{{ pathto('_static/conf/images/pics/reg.jpg', 1) }}" alt="Group photo" style="padding: 25px;">
</span>
</div>


<div class="about-content">
<h2>Past attendees have said</h2>

Expand All @@ -251,18 +255,6 @@ <h2>Past attendees have said</h2>
<p class="testimonial-author">- <a href="https://heyawhite.com/about/">Alexandra White, Senior Tech Writer at Google</a></p>
</div>

<div class="picture-set">
<div data-aos="pictrue-03" data-aos-once="true">
<img src="{{ pathto('_static/conf/images/pics/pictrue-03.jpg', 1) }}" alt="" >
</div>
<div data-aos="pictrue-02" data-aos-once="true">
<img src="{{ pathto('_static/conf/images/pics/pictrue-02.jpg', 1) }}" alt="" >
</div>
<div data-aos="pictrue-01" data-aos-once="true">
<img src="{{ pathto('_static/conf/images/pics/pictrue-01.jpg', 1) }}" alt="" >
</div>
</div>

</div>
</div>

Expand Down
5 changes: 3 additions & 2 deletions docs/blog/2024-Q4-community-board.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,14 +16,15 @@ Our Q4 meeting covered several initiatives that the team leads have been working

* **The future of jobs and hiring support in the community:** Following the deprecation of the job board and launch of the new job sponsorship offering (announced in the `October newsletter <https://www.writethedocs.org/blog/newsletter-october-2024/>`_), the WTD organization aims to better align with the changing trends in documentarian jobs and hiring practices. We recognized that having a standalone job board is no longer the best place for connecting our community members with potential jobs, and we hope that the new sponsorship options will provide a better experience for job seekers and hiring organizations.

We are also looking at the job-related Slack spaces to make sure that they continue to best serve the community. One of the questions that came up was around moderation of job postings in Slack, and our moderation team is investigating whether there is a need for more strict moderation of these types of posts based on feedback from the community.
We are also looking at the job-related Slack spaces to make sure that they continue to best serve the community. One of the questions that came up was around moderation of job postings in Slack, and our moderation team is investigating whether there is a need for more strict moderation of these types of posts based on feedback from the community.

* **The future of virtual conferences:** Now that another very successful Atlantic conference is behind us, we are starting to think about what the next year(s) will bring for this type of event. What started out in 2020 as a swift response to COVID-19 restrictions became a much-loved part of our community experience, especially for folks who can't travel to in-person events for financial, logistical, or personal reasons.

While we'd love to keep running virtual events regularly, we also recognize the need to improve the organizer experience for sustainability, as well as the need to focus on the audience that would benefit the most out of these events. As we start planning next year's virtual event, we'll be reviewing the data from past virtual conferences as well as sourcing feedback from the community and incorporating it into the decision process.
While we'd love to keep running virtual events regularly, we also recognize the need to improve the organizer experience for sustainability, as well as the need to focus on the audience that would benefit the most out of these events. As we start planning next year's virtual event, we'll be reviewing the data from past virtual conferences as well as sourcing feedback from the community and incorporating it into the decision process.

* **The future of the WTD website and guides:** Ever since we launched the documentation guides and resources on our website, we've relied on volunteers to maintain the pages and keep the information up to date. This methodology has had its ups and downs over the years, and recently it has become apparent that the main community website content is in need of more dedicated maintainers. The newsletter team is looking into various options to improve volunteer engagement beyond the newsletter itself, and will be sending out calls to action for folks who might be interested in more long-term involvement as well as possible short-term internship-style contributions.


* **The future of meetups:** The meetups team continues to diligently manage active meetup.com groups that WTD has been supporting, to ensure that active meetups get the support they need while ensuring that the WTD organization is not paying for meetup groups that have been inactive for an extended period of time. They are also reviewing possible alternatives to meetup.com and continuing to observe global trends in online engagement for meetups and community groups.

As always, the board continues to review the community backlog to determine what are the most valuable efforts for the community in the short and long term.
Expand Down
Loading

0 comments on commit 93b1cdd

Please sign in to comment.