From 73290622a59fdf76b672279889e406fb56d53769 Mon Sep 17 00:00:00 2001 From: Eric Holscher Date: Fri, 5 Dec 2025 09:13:26 -0600 Subject: [PATCH 01/14] 2026 Portland website launch Updates based on feedback from Katie --- docs/_templates/2026/menu-desktop.html | 4 +- docs/_templates/2026/menu-mobile.html | 4 +- docs/conf/portland/2026/about.md | 2 +- .../portland/2026/convince-your-manager.md | 4 +- docs/conf/portland/2026/hike.md | 12 +-- docs/conf/portland/2026/lightning-talks.md | 16 +--- docs/conf/portland/2026/opportunity-grants.md | 4 +- docs/conf/portland/2026/social-events.md | 4 +- docs/conf/portland/2026/unconference.md | 18 ++-- docs/conf/portland/2026/venue.md | 8 +- docs/conf/portland/2026/volunteer.md | 14 ++- docs/conf/portland/2026/writing-day.md | 89 +------------------ 12 files changed, 30 insertions(+), 149 deletions(-) diff --git a/docs/_templates/2026/menu-desktop.html b/docs/_templates/2026/menu-desktop.html index 5ed9097f67..9d0f0dd8e2 100644 --- a/docs/_templates/2026/menu-desktop.html +++ b/docs/_templates/2026/menu-desktop.html @@ -63,11 +63,13 @@ {% if not flagisvirtual %}
  • Visiting {{ city }}
  • Attendee Guide
    • -
  • Health and Safety Policy
  • Volunteer Info
    • {% endif %}
  • Virtual Attendance
    • + {% if not flagisvirtual %} +
  • Health and Safety Policy
    • + {% endif %}
  • Code of Conduct
    • {% if flagspeakersannounced %}
  • Meet the Team
    • diff --git a/docs/_templates/2026/menu-mobile.html b/docs/_templates/2026/menu-mobile.html index a4c297b757..7b7b4c46ba 100644 --- a/docs/_templates/2026/menu-mobile.html +++ b/docs/_templates/2026/menu-mobile.html @@ -48,10 +48,12 @@ {% if not flagisvirtual %}
  • Visiting {{ city }}
  • Attendee Guide
    • -
  • Health and Safety Policy
  • Volunteer Info
    • {% endif %}
  • Virtual Attendance
    • + {% if not flagisvirtual %} +
  • Health and Safety Policy
    • + {% endif %}
  • Code of Conduct
    • {% if flagspeakersannounced %}
  • Meet the Team
    • diff --git a/docs/conf/portland/2026/about.md b/docs/conf/portland/2026/about.md index 9a5331bed7..e76056c0c8 100644 --- a/docs/conf/portland/2026/about.md +++ b/docs/conf/portland/2026/about.md @@ -10,5 +10,5 @@ We invite you to join hundreds of other folks for a three-day event to explore t The Write the Docs conference covers any topic related to documentation in the software industry. Past talks have also covered such diverse topics as empathy, the history of math symbols, and using emoji to keep your users' attention. -Write the Docs brings *everyone* who writes the docs together in the same room: Writers, developers, support engineers, community managers, developer relations, and more. +Write the Docs brings *everyone* who writes the docs together in the same room: writers, developers, support engineers, community managers, developer relations, and more. We all have things to learn, and there's no better way than gathering at our events and sharing knowledge. diff --git a/docs/conf/portland/2026/convince-your-manager.md b/docs/conf/portland/2026/convince-your-manager.md index 330fb5a119..14a61bd809 100644 --- a/docs/conf/portland/2026/convince-your-manager.md +++ b/docs/conf/portland/2026/convince-your-manager.md @@ -24,7 +24,7 @@ Remember to change the things in [brackets]! *Write the Docs conferences bring together everyone who writes the docs – Tech Writers, Developers, Developer Relations, Customer Support – making the events an ideal networking opportunity. Each conference successfully combines a number of different event formats to deliver engaging, practical, and timely content.* -*There is a single track of talks, a parallel unconference event, and a community writing day. The [sessions from last year](https://www.writethedocs.org/conf/portland/2024/speakers/) will give you a good idea of the kinds of topics covered, many of which are relevant to my work.* +*There is a single track of talks, a parallel unconference event, and a community writing day. The [sessions from last year](https://www.writethedocs.org/conf/portland/2025/speakers/) will give you a good idea of the kinds of topics covered, many of which are relevant to my work.* *Costs:* @@ -94,7 +94,7 @@ Peer review new and existing documentation* When discussing how to pitch Writing Day, a few helpful tips emerged: -- Highlight specific projects from a previous [Writing Day project list. ](https://www.writethedocs.org/conf/portland/2023/writing-day/#project-listing) +- Highlight specific projects from a previous [Writing Day project list.](https://www.writethedocs.org/conf/portland/2025/writing-day/#project-listing) - If your community is looking for regular documentation contributions, this is a great place to onboard potential contributors and editors. - Attending raises the visibility of your company in the community. - Establishes your team's reputation for caring about their docs. diff --git a/docs/conf/portland/2026/hike.md b/docs/conf/portland/2026/hike.md index 439509099d..43f6e92004 100644 --- a/docs/conf/portland/2026/hike.md +++ b/docs/conf/portland/2026/hike.md @@ -12,17 +12,7 @@ We will be hiking in the amazing [Forest Park](https://forestparkconservancy.org **The hike is around 5 miles long with 1,200 feet of elevation gain and is classified as a moderate hike. We’ll be going nice and slow so people can appreciate the views and forest.** -It’s rained on us in the past, but we have faith it will be beautiful this year! We will hopefully see Mount Hood at the top :) - -

    - - - - -
    - Sign up for the hike with a free ticket -
    -

    +It's rained on us in the past, but we have faith it will be beautiful this year! We will hopefully see Mount Hood at the top :) ## Schedule & Logistics diff --git a/docs/conf/portland/2026/lightning-talks.md b/docs/conf/portland/2026/lightning-talks.md index bd57e3998a..8be4521c19 100644 --- a/docs/conf/portland/2026/lightning-talks.md +++ b/docs/conf/portland/2026/lightning-talks.md @@ -10,16 +10,6 @@ A Lightning Talk is a brief presentation, lasting up to five minutes, where you Lightning Talks are a fantastic opportunity for first-time speakers. Regardless of your speaking experience, we invite you to submit a talk. -

    - - - - -
    - Submit a Lightning Talk -
    -

    - **Supporting first-time speakers is important to us, so we have created two speaker categories:** - First-time speakers @@ -35,10 +25,8 @@ Submit your Lightning Talk in person at the registration/check-in table. **Submissions are open:** -- During Writing Day on Sunday -- Monday morning, until the end of the last morning break -- Monday afternoon, post-Monday Lightning Talks -- Tuesday morning, until the end of the last morning break +- One week prior to the conference (Monday submissions only) +- During the conference from Sunday to Tuesday morning, until the end of the last morning break **Speaker selection and announcements:** diff --git a/docs/conf/portland/2026/opportunity-grants.md b/docs/conf/portland/2026/opportunity-grants.md index 6e05616531..cec924696e 100644 --- a/docs/conf/portland/2026/opportunity-grants.md +++ b/docs/conf/portland/2026/opportunity-grants.md @@ -23,7 +23,7 @@ Grant applicants, like all other participants in the Write the Docs community, a ## Schedule - **Now - {{ grants.ends }}:** Grant applications open -- **{{ grants.notification }}:** Grant recipients notified +- **February 13, 2026:** Grant recipients notified ## What is Covered @@ -42,7 +42,7 @@ The application form will ask for an estimate of your costs. ## Grant Amounts -The total amount of grant funds to be distributed is based upon sponsors and number of tickets sold. We will not know the full amount until we near the deadline. In 2024, $3,500 was distributed in grant funds. There is no limit on the amount you request, but please consider this amount when making your request. We rarely fund only one individual and aim to use our budget for two or more people. We do not award partial grants. +The total amount of grant funds to be distributed is based upon sponsors and number of tickets sold. We will not know the full amount until we near the deadline. For 2026, we have $3,500 total to distribute for grant funds. There is no limit on the amount you request, but please consider this amount when making your request. We rarely fund only one individual and aim to use our budget for two or more people. We do not award partial grants. ## Are you part of a marginalized or underrepresented group in tech? diff --git a/docs/conf/portland/2026/social-events.md b/docs/conf/portland/2026/social-events.md index 824ec1f5b8..9c8c36d42e 100644 --- a/docs/conf/portland/2026/social-events.md +++ b/docs/conf/portland/2026/social-events.md @@ -26,9 +26,7 @@ and make sure you know your way around the conference venue. Join us for our Monday night social event! This is a great chance to meet more of your fellow documentarians and chat about the conference in a relaxed atmosphere. -**Where**: {{about.social_venue}} +**Where**: TBD **When**: 7-9 PM *Both alcoholic and non-alcoholic drinks and snacks will be provided.* - -Sponsored by [Mintlify](https://mintlify.com/?utm_source=writethedocs&utm_medium=referral)! diff --git a/docs/conf/portland/2026/unconference.md b/docs/conf/portland/2026/unconference.md index 56bab72ae6..3afc312793 100644 --- a/docs/conf/portland/2026/unconference.md +++ b/docs/conf/portland/2026/unconference.md @@ -12,16 +12,6 @@ The Unconference consists of attendee-driven sessions that provide the opportuni Everyone! All attendees are invited to lead a session on a topic. Sessions can be organized around a presentation, group discussion or anything in between. -

    - - - - -
    - Sign up to Lead an Unconference Session -
    -

    - **Who can attend an Unconference session?** Everyone! @@ -36,9 +26,11 @@ Everyone! - Each session is 40 minutes in length ### Scheduling a Session -- Sign up during Writing Day or the Welcome Reception on Sunday, and anytime during the conference on Monday and Tuesday. -- Write the title and your name on a note. Select a time slot and table number and place the note on the large schedule. You can only sign up in person. -- The online version will be updated periodically throughout the conference. + +- Sign up online one week prior to the conference (Monday morning sessions only). +- Sign up for all sessions in-person anytime during the conference, Sunday through Tuesday. +- During the conference, write the title and your name on a sticky note. Select a time slot and table number and place the note on the large schedule. +- The online schedule will be available to view only during the conference. This will be updated regularly. Exact times to be posted on our [Schedule](/conf/{{shortcode}}/{{year}}/schedule) page. diff --git a/docs/conf/portland/2026/venue.md b/docs/conf/portland/2026/venue.md index 881c3a469a..c9868a63ef 100644 --- a/docs/conf/portland/2026/venue.md +++ b/docs/conf/portland/2026/venue.md @@ -17,15 +17,15 @@ Our conference will be held at Revolution Hall, a beautiful venue located in the If you drive to the conference, note that the venue does not have parking onsite. There is street parking east of the venue (15th Ave. and higher street numbers) and allows for all-day free parking. Additionally, there is 1-2 hour street parking directly around the venue. -Bus transit stops are located near the venue. All transit in Portland announce major stops verbally in English, and most buses have a visual display of upcoming stops. Refer to the [Visiting Portland page](https://www.writethedocs.org/conf/portland/2026/visiting/) for more information on public transportation. +Bus transit stops are located near the venue. All transit in Portland announce major stops verbally in English, and most buses have a visual display of upcoming stops. More information on public transportation will be shared as the conference nears. ## Conference Layout ### Registration and Welcome Wagon **Location:** -- May 2: 1st floor near Martha's Cafe -- May 3-5: 2nd floor +- May 3: 1st floor near Martha's Cafe +- May 4-5: 2nd floor ### Writing Day, Unconference, and Welcome Reception @@ -41,7 +41,7 @@ Bus transit stops are located near the venue. All transit in Portland announce m ### Other Venue Spaces (open to the public) -- Martha’s Coffee: 7-3pm +- Martha's Coffee: 7am-3pm - Show Bar: 3-11pm - Roof Deck: 3-11pm, weather permitting - Outdoor seating and city park diff --git a/docs/conf/portland/2026/volunteer.md b/docs/conf/portland/2026/volunteer.md index 513b288881..63f140b680 100644 --- a/docs/conf/portland/2026/volunteer.md +++ b/docs/conf/portland/2026/volunteer.md @@ -6,7 +6,7 @@ banner: _static/conf/images/headers/2025/volunteer.jpg # Volunteer Information -Our volunteer application is open! We are looking for volunteers to provide support with a variety of conference roles - registration, Writing Day, Unconference, stage support, catering, load out, and more. +Our volunteer sign up form is open. We are looking for volunteers to provide support with a variety of conference roles - registration, Writing Day, Unconference, float, catering, load out, and more. Completing this form signs you up to volunteer. We will close the form once volunteer capacity is reached. Another form will be sent out once the speaker schedule is released mid-February. @@ -24,8 +24,8 @@ Each individual must volunteer for two or more 3-4 hour shifts and receives a ** **Timeline:** -- **Now - February 14**: Volunteer applications open -- **February 14 - March 26**: Volunteer schedule sign up open +- **Now-February 13**: Volunteer applications open +- **February 13-March 27**: Volunteer schedule sign up open - **End of March**: Volunteer schedule emailed ## Volunteer Roles @@ -38,17 +38,13 @@ Each individual must volunteer for two or more 3-4 hour shifts and receives a ** - Check in attendees, provide general information inquiries, answer venue questions, and field other requests or direct individuals to the correct staff member who can provide support. -### Stage Support - -- Assist presenters while on stage - troubleshoot issues with slides, video, or audio portions of their presentation. Please apply for this role if you have some A/V knowledge; it is not required, but experience with different operating systems is a plus! - ### Unconference - Assist the Unconference coordinator, help folks sign up to host a session, maintain an updated schedule, direct individuals and groups to their tables, and keep tables looking neat. -### Catering +### Float -- Set up catering, replenish beverages and snacks, and notify venue staff of coffee refills and cleaning needs. +- Provide support where needed. Be a runner. Support staff with catering set up. ### Venue Load Out diff --git a/docs/conf/portland/2026/writing-day.md b/docs/conf/portland/2026/writing-day.md index 3a7f836a3a..edfc8865a4 100644 --- a/docs/conf/portland/2026/writing-day.md +++ b/docs/conf/portland/2026/writing-day.md @@ -33,13 +33,7 @@ If you have a project, we encourage you to submit it before the conference! This - 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). - -
    -
    - Submit your Writing Day project -
    -
    +Find specific examples on the [Portland Writing Day 2025 project list](https://www.writethedocs.org/conf/portland/2025/writing-day/#project-listing). ## Schedule @@ -73,12 +67,6 @@ Come with the following tools: 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. -
    -
    - Submit your Writing Day project -
    -
    - **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. @@ -105,78 +93,3 @@ Writing Day is the perfect opportunity to participate and learn about new projec **We're excited to have another wonderful Writing Day!** - -## Project List - -### Enhance Your Portfolio! Contribute to an Open Source Repository - -Project organizer: Mike Jang, he/him. - -While we've open sourced our enterprise [documentation repository](https://github.com/nginx/documentation), we've done something different. We've set up [Good first issues](https://github.com/nginx/documentation/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22good%20first%20issue%22) that do not require Git knowledge. - -We love all types of contributions. Examples: - -- We have not completed our move towards "sentence case" in our headings -- We are missing alternative text for a few of our screenshots - -If you've never used git or if you're already an expert, we welcome your contributions. - -If you're a technical expert, our Good first issues give you the chance to test our how-tos and tutorials! If you remember Manny Silva's [Docs as Tests](https://www.docsastests.com/), several of our Good first issues include testable procedures. - -**And we hope to have interesting swag!** - -### Docs as Tests and Doc Detective: Help us test your docs! - -Project organizer: Manny Silva, he/him. Project session: All day. - -[Docs as Tests](https://www.docsastests.com/) and [Doc Detective](https://doc-detective.com/) are back at Writing Day and our goal is to test at least 10 docs sets! Does your project or product have a UI? APIs? SDKs? We can help you test them and keep your docs accurate. - -Docs as Tests is a strategy for keeping docs up-to-date by treating procedures and code snippets as testable assertions of product behavior. You have the docs, so let's get testing! By validating that documentation contents work as written, you can: - -- Prevent broken docs -- Ensure consistent UX between docs and products -- Build user trust - -We want every writer to be confident in their docs. Come by our table, and we’ll help you set up Docs as Tests with whatever tools (like Doc Detective) or strategies (like unit testing code snippets) are appropriate. Establish a zero-trust relationship between your docs and product, catching bugs in both as you go. - -### Help improve the WTD Salary Survey - -* Project organizer: Kay Smoljak, she/her. -* Project session: Afternoon. - -The [Write the Docs Salary Survey](https://writethedocs.org/surveys/) has been running annually since 2019, with the goal of identifying appropriate salary ranges and providing a basis for pay negotiations. - -Our goal for Writing Day is to improve the clarity, inclusivity, neutrality and relevance of the [questions, instructions, and general flow of the survey](https://github.com/writethedocs/salary-survey?tab=readme-ov-file#write-the-docs-annual-documentation-salary-survey). - -### Research the Docs! (Sponsor session) - -Project organizer: Kyle Rollins, he/him. Project session: All day. - -Join the MongoDB docs and design teams for a dual-purpose documentation research project. - -*What is this?* - -* An opportunity to work with a product designer on a research activity. -* Learn how to give qualitative feedback using MongoDB documentation. - -*Why participate?* - -* Join us to experience professional product research in action. -* Leave with the knowledge and materials to facilitate your own documentation research project. - -Your participation helps the MongoDB team better understand the MongoDB docs’ strengths and weaknesses. It also gives MongoDB team the opportunity to share how you can facilitate your own documentation research project. We appreciate your help in making the MongoDB documentation the best that it can be. - -### Crowdsource the Docs: Help improve Docker's API reference - -Project organizer: Sarah Sanders, she/her. Project session: All day. - -[Docker’s API Docs](https://github.com/docker/docs/tree/main/content/reference/api) are critical for developers and they could use some TLC! Docker's API docs are a part of our open source offerings. We need your help to crowdsource and implement feedback to improve our API documentation. - -Our goal is to work together to make the docs more clear, helpful, and user-friendly. - -Here's our plan of action: - -* Review the current Docker API pages to identify gaps and UX issues. -* Brainstorm ways to improve clarity, usefulness, and approachability. - -Whether you're great at structuring docs, writing clear examples, identifying pain points, or just love helping others understand complex systems - this project is for you! From c0870277668ceee7d5d2577add2606593b4a3f91 Mon Sep 17 00:00:00 2001 From: Eric Holscher Date: Fri, 5 Dec 2025 09:16:38 -0600 Subject: [PATCH 02/14] Remove photo --- docs/conf/portland/2026/unconference.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/conf/portland/2026/unconference.md b/docs/conf/portland/2026/unconference.md index 3afc312793..1f71521401 100644 --- a/docs/conf/portland/2026/unconference.md +++ b/docs/conf/portland/2026/unconference.md @@ -16,8 +16,6 @@ Everyone! All attendees are invited to lead a session on a topic. Sessions can b Everyone! -![Unconference 1](/_static/conf/images/pics/2025/unconference.jpg) - ## Schedule **Date: {{ unconf.date }}** From 372659190ccfe2f23600d052fd29b70a43ea6fd6 Mon Sep 17 00:00:00 2001 From: Eric Holscher Date: Fri, 5 Dec 2025 09:20:48 -0600 Subject: [PATCH 03/14] Adjust nav --- docs/_data/portland-2026-config.yaml | 9 +++++++-- docs/_templates/2026/menu-desktop.html | 6 +++++- docs/_templates/2026/menu-mobile.html | 6 +++++- 3 files changed, 17 insertions(+), 4 deletions(-) diff --git a/docs/_data/portland-2026-config.yaml b/docs/_data/portland-2026-config.yaml index a5bf06e8db..b461287ce5 100644 --- a/docs/_data/portland-2026-config.yaml +++ b/docs/_data/portland-2026-config.yaml @@ -203,7 +203,7 @@ sponsors: in_kind: # Things that change over time, listed in order of change -flaglanding: True +flaglanding: False flaghassponsors: False flagcfp: True flagticketsonsale: False @@ -213,7 +213,7 @@ flagrunofshow: False flaghasschedule: False flagscheduleincomplete: True flaghasshirts: False -flaglivestreaming: True +flaglivestreaming: False flagvideos: False flagpostconf: False flaghasbadgeflair: False @@ -226,3 +226,8 @@ flaghaswritingday: True flaghaslightningtalks: True flaghasjobfair: True flaghasboat: False + +# Pages to be linked in January 2026 +flaghasvisiting: False +flaghasattendeeguide: False +flaghasteam: False diff --git a/docs/_templates/2026/menu-desktop.html b/docs/_templates/2026/menu-desktop.html index 9d0f0dd8e2..daf4cbe431 100644 --- a/docs/_templates/2026/menu-desktop.html +++ b/docs/_templates/2026/menu-desktop.html @@ -61,8 +61,12 @@