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

2025 site copy updates #2267

Merged
merged 29 commits into from
Dec 12, 2024
Merged
Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
027e020
Full portland 2025 site
ericholscher Nov 11, 2024
e751e30
Add news index
ericholscher Nov 19, 2024
8f6fa9a
Merge branch 'main' of github.com:writethedocs/www into pdx-25-site
ericholscher Nov 19, 2024
1e6bed2
Add writing day image
ericholscher Dec 9, 2024
758ce88
Add news post
ericholscher Dec 9, 2024
28fd82a
Small futzing
ericholscher Dec 9, 2024
a167a1d
Copy updates
ericholscher Dec 10, 2024
7c5b118
Lots of file changes
ericholscher Dec 10, 2024
f3f3c0a
Fix headers
ericholscher Dec 10, 2024
9cfd393
Add grants url
ericholscher Dec 10, 2024
eb16799
Add banners
ericholscher Dec 10, 2024
15315b6
Merge branch 'main' of github.com:writethedocs/www into pdx-25-site
ericholscher Dec 10, 2024
f9c73ce
Remove sponsor expo and twitter link
ericholscher Dec 10, 2024
5eb2526
More edits
ericholscher Dec 10, 2024
d91c821
Update volunteer page
ericholscher Dec 11, 2024
0811d18
Apply suggestions from code review
ericholscher Dec 11, 2024
ec11f8b
Adjust banners
ericholscher Dec 11, 2024
98fbe9c
Lots of content updates
ericholscher Dec 11, 2024
48589e3
Update dates
ericholscher Dec 11, 2024
ed0d89a
Add wrtiting day 2 photo
ericholscher Dec 11, 2024
4147ec6
Cleanup speak link
ericholscher Dec 11, 2024
0b4e402
Update volunteer page
ericholscher Dec 11, 2024
55cf1bd
Update menu
ericholscher Dec 12, 2024
73568d5
Update volunteer.md
katiejano Dec 12, 2024
456f92d
Apply suggestions from code review
ericholscher Dec 12, 2024
091ec1b
Update volunters and ticket page
ericholscher Dec 12, 2024
62463e2
More images
ericholscher Dec 12, 2024
823fe93
A couple copy edits
ericholscher Dec 12, 2024
ad5f740
Fix headings
ericholscher Dec 12, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/_data/portland-2025-config.yaml
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
Original file line number Diff line number Diff line change
Expand Up @@ -261,7 +261,7 @@ sponsors:
# brand: Read the Docs

# Things that change over time, listed in order of change
flaglanding: True
flaglanding: False
flaghassponsors: True
flagcfp: True
flagticketsonsale: False
Expand Down
59 changes: 59 additions & 0 deletions docs/conf/portland/2025/news/announcing-tickets.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
:template: {{year}}/generic.html
:og:image: _static/conf/images/headers/{{shortcode}}-{{year}}-opengraph.jpg

.. post:: Dec 12, 2024
:tags: {{shortcode}}-{{year}}, website, cfp, tickets

Tickets on Sale for Write the Docs Portland 2025
================================================

Happy December, documentarians!

We’re thrilled to announce that `tickets are now available for Write the Docs Portland 2025 <https://www.writethedocs.org/conf/{{shortcode}}/{{year}}/tickets/>`_!

Join us for our 13th annual conference in Portland. It's a great opportunity to meet fellow documentarians, learn new skills, and get inspired.

We have some high-level information for you below.

Full website is available
-------------------------

Our `full event website <https://www.writethedocs.org/conf/{{shortcode}}/{{year}}/>`_ is live with information about all the events and basic travel information.

The website has lots of information about the conference events. Stay tuned for updates more updates on food, transportation and other information.

Opportunity Grants
------------------

Interested in attending but need extra financial support? We strive to provide an accessible conference for folks of all backgrounds to join. Our opportunity grant application is now open.

Visit our `Opportunity Grants page <https://www.writethedocs.org/conf/{{shortcode}}/{{year}}/opportunity-grants/>`_ for more information.

Volunteers
----------

Our volunteers make the conference happen each year, and it's a great group of folks. Want to help out and attend for free? Volunteer with us this year!

Visit our `volunteer page <https://www.writethedocs.org/conf/{{shortcode}}/{{year}}/volunteer/>`_ to learn more and sign up.

Call for Proposals
------------------

Our Call for Proposals is still open, and we'd love for you to be part of the conference this year.

Our `Call for Proposals <https://www.writethedocs.org/conf/{{shortcode}}/{{year}}/cfp/>`_ page has more details, and all the information you need to submit a talk.

**Submit your talk by {{ cfp.ends }}!**

Thanks to our sponsors
----------------------

We appreciate the support of our sponsors. Thank you to the following companies:

.. datatemplate::
:source: /_data/{{shortcode}}-{{year}}-config.yaml
:template: {{year}}/sponsors-simplelist.rst

Your company can `become a sponsor <https://www.writethedocs.org/conf/{{shortcode}}/{{year}}/sponsors/prospectus/>`_ today!

We're excited to see everyone in Portland.
114 changes: 114 additions & 0 deletions docs/conf/portland/2025/writing-day.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,114 @@
---
template: {{year}}/generic.html
og:image: _static/conf/images/headers/{{shortcode}}-{{year}}-opengraph.jpg
---

What is Writing Day?
====================


<div class="about" id="about">
<div class="uk-container">
<div class="about-content">
<p>
Writing Day is modeled after the concept of “sprints” or “hackathons”, which are common in open-source software (OSS) conferences.
</p>
<p>
On the first day of the conference, Sunday, attendees are encouraged to bring and lead a project, or contribute to another attendee's project.
</p>
<p>
The primary goal is to bring interesting individuals into the same room, sharing their passions and aspirations while collaborating to develop creative solutions to solve a problem or issue.
</p>
</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="/_static/conf/images/pics/writing-day.jpg" alt="Group photo" style="padding: 25px;">
</span>
</div>
</div>
</div><!-- end about -->

If you have a project, we encourage you to submit it before the conference! This is a great way to build momentum and get other attendees excited to participate in your project. We’ll open project submissions in February/March. As usual, day-of projects are always welcome too - you'll have the option to sign up onsite and announce it during Writing Day.

Writing Day is modeled after the concept of “sprints” or “hackathons”, which are common in open-source software (OSS) conferences.

On the first day of the conference, Sunday, attendees are encouraged to bring and lead a project, or contribute to another attendee's project.

The primary goal is to bring interesting individuals into the same room, sharing their passions and aspirations while collaborating to develop creative solutions to solve a problem or issue.

If you have a project, we encourage you to submit it before the conference! This is a great way to build momentum and get other attendees excited to participate in your project. We’ll open project submissions in February/March. As usual, day-of projects are always welcome too - you'll have the option to sign up onsite and announce it during Writing Day.

ericholscher marked this conversation as resolved.
Show resolved Hide resolved
**There are two ways to participate in Writing Day:**
ericholscher marked this conversation as resolved.
Show resolved Hide resolved

- Project Lead: You bring an idea, content, or OSS project to work on with contributors.
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
- Contributors: You are looking to contribute to various hosted projects.
ericholscher marked this conversation as resolved.
Show resolved Hide resolved

**Here are examples of projects that you might see at the conference:**

- Open-source software documentation
- General documentation writing
- Best practices manual (for your company, or the world)
- Resume, cover letter, and portfolio reviews
- Blog posts
- Tips and tricks
- Great works of fiction
- Love letters
- The Documentarian Manifesto

Find specific examples on the [Portland Writing Day 2023 project list](https://www.writethedocs.org/conf/portland/2023/writing-day/#project-listing).

## Schedule

**Date: {{ date.conference.date }}**
ericholscher marked this conversation as resolved.
Show resolved Hide resolved

Writing Day is an all day event designed with flexibility in mind. Feel free to check out as many projects as make sense for you and your schedule!

- Morning Session:
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
- Welcome and overview
- Project announcements: Leads give a 2 minute summary
- Projects and co-working begins
- Lunch Break
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
- Afternoon Session
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
- Project announcements: Leads give a 2 minute project summary, starting with the afternoon-only projects
- Projects and co-working reconvenes
- Writing Day ends at 5pm
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
ericholscher marked this conversation as resolved.
Show resolved Hide resolved

Exact times to be posted on our :doc:`/conf/{{shortcode}}/{{year}}/Schedule` page.

## How to Prepare

Come with the following tools:

- Laptop, tablet, or other device
- GitHub account (you may also want a GitLab account)
- Text editor of your choice for coding or content creation

ericholscher marked this conversation as resolved.
Show resolved Hide resolved
## Lead a Project

Leading a project at Writing Day is a wonderful opportunity to engage with documentarians from a variety of backgrounds, experience, and expertise. Their collective wealth of experience can upgrade your documentation and create a more inclusive project. This empowers all of us to work together to create opportunities for each other and bigger, better communities
ericholscher marked this conversation as resolved.
Show resolved Hide resolved

**Tips to create and lead a new project effectively:**

- **Provide a project overview with a specific focus or goals:** Your overview is a 2 minute pitch that describes your project and clearly defines a focus area or goal. Here’s a good example from Writing Day _____.
- **Pre-label tasks and issues:** Create a specific event label and label documentation tasks and issues. This empowers new contributors to find tasks that interest them.
- **Create a task filter:** This helps contributors find issues more easily and see which issues have been assigned.
- **Clear onboarding:** Ensure your ReadMe, contribution guidelines, or onboarding instructions are accurate and up to date.
- **Project experts:** We recommend having 1-2 project experts on your project. We love our developer advocates, community managers, and subject matter experts! You’re welcome to ask for virtual reinforcements from your community as well.
- **Flexibility and understanding:** Reminder that attendees may need additional info to be successful in onboarding to your project.
- **Submit your Writing Day before the conference:** Projects submitted by April 17, 2025, are featured in our pre-conference blog post and email. Many attendees have shared that their curiosity for specific projects motivated them to attend. Project submissions open in February/March.

These are suggestions and not requirements. It is perfectly valid to show up to Writing Day, tell us about your project day of, and ask for attendee contribution! It’s been done before and it will be done again.

## Contribute to a Project


Writing Day is the perfect opportunity to participate and learn about new projects and technologies. You are welcome to stay with one project all day, or project hop. Do what feels right to you.

**Tips to contribute to a project:**

- **Regardless of your experience level, you are welcome here!** We're excited to have you. Even if you feel you lack the right skills, experiences, or have never attended an event like Writing Day before, you’ll be surprised at how much you can contribute.
- **Explore our guide to writing documentation!** Our [beginner’s guide](<https://www.writethedocs.org/guide/writing/beginners-guide-to-docs/>) is designed to help you get started and spark ideas for how you can contribute to a project.
- **Ask questions!** If you encounter challenges with new concepts and tools, you are in a room surrounded by friendly people from diverse backgrounds and experiences. You can always ask the Welcome Wagon or Registration staff and volunteers. We will help you connect with the right person!
- **View the project list.** Check out the projects that have been submitted in advance. Keep in mind that some attendees choose to announce their projects during Writing Day itself, so these projects might not appear on the list in advance.

#### We're excited to have another wonderful Writing Day!

Check warning on line 114 in docs/conf/portland/2025/writing-day.md

View workflow job for this annotation

GitHub Actions / sphinx-ubuntu

Non-consecutive header level increase; H2 to H4 [myst.header]
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
Loading
Loading