Skip to content

Commit

Permalink
Merge pull request #2267 from writethedocs/pdx-25-site
Browse files Browse the repository at this point in the history
2025 site copy updates
  • Loading branch information
ericholscher authored Dec 12, 2024
2 parents b1e50d4 + ad5f740 commit 7c7c098
Show file tree
Hide file tree
Showing 35 changed files with 653 additions and 950 deletions.
17 changes: 10 additions & 7 deletions docs/_data/portland-2025-config.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
name: Portland

shortcode: portland
year: 2025
city: Portland
Expand All @@ -14,7 +13,7 @@ hex: 3dd94a
time_format: 12h

photos:
default: _static/conf/images/headers/portland-2024-group.jpg
default: _static/conf/images/headers/portland-2025-small-group.jpg

buttons:
top:
Expand Down Expand Up @@ -83,8 +82,8 @@ sponsorship:
price: $14,000

grants:
url: ""
ends: 'February 1, 2025'
url: https://docs.google.com/forms/d/e/1FAIpQLSf3fGfW_8W1x3oeKeoUpg8ZPLvyY4cQvO5Bii_OTrgW97cLNw/viewform?embedded=true
ends: 'February 5, 2025'
notification: 'February 14, 2025'

shirts:
Expand Down Expand Up @@ -163,7 +162,11 @@ cfp:

unconf:
url: ""
date: "All day Monday and Tuesday"
date: "All day, Monday, May 5 and Tuesday, May 6"

writing_day:
url: ""
date: Sunday, May 4, 9 AM - 5 PM

hike:
date: Saturday, May 3, 2 PM
Expand Down Expand Up @@ -265,10 +268,10 @@ 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
flagticketsonsale: True
flagsoldout: False
flagspeakersannounced: False
flagrunofshow: False
Expand Down
7 changes: 6 additions & 1 deletion docs/_data/schema-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@ cfp: include('cfp-details', required=False)
grants: include('grants-details', required=False)
shirts: include('shirts-details', required=False)
unconf: include('unconf-details', required=False)
writing_day: include('writing_day-details', required=False)
lightning_talks: include('lightning_talks-details', required=False)
hike: include('hike-details', required=False)

Expand Down Expand Up @@ -191,8 +192,12 @@ unconf-details:
url: str(required=True)
date: str(required=False)

writing_day-details:
url: str(required=False)
date: str(required=True)

hike-details:
date: str(required=False)
date: str(required=True)

lightning_talks-details:
signup_url: str(required=True)
Binary file added docs/_static/conf/images/headers/2025/grants.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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/2025/volunteer.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 0 additions & 3 deletions docs/_templates/2025/base.html
Original file line number Diff line number Diff line change
Expand Up @@ -97,9 +97,6 @@ <h2 class="uk-first-column"><a href="/conf/{{ shortcode }}/{{ year }}/sponsors/"
<a href="https://www.linkedin.com/company/write-the-docs">
<img style="height: 25px; border-radius: 5px;" src="{{ pathto('_static/conf/images/icons/linkedin.png', 1) }}" alt="LinkedIn">
</a>
<a href="https://twitter.com/writethedocs">
<img src="{{ pathto('_static/conf/images/icons/twitter-footer-white.svg', 1) }}" alt="Twitter">
</a>
<a href="https://www.flickr.com/photos/writethedocs/">
<img src="{{ pathto('_static/conf/images/icons/flickr-footer-white.svg', 1) }}" alt="Flickr">
</a>
Expand Down
17 changes: 13 additions & 4 deletions docs/_templates/2025/menu-desktop.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,9 @@
<a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/schedule') }}">Program</a>
<div class="uk-navbar-dropdown">
<ul class="uk-nav uk-navbar-dropdown-nav">
{% if flaghasschedule %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/schedule') }}">Schedule</a></li>
{% endif %}
{% if flagspeakersannounced %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/speakers') }}">Speakers</a></li>
{% endif %}
Expand All @@ -17,9 +19,6 @@
{% endif %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/lightning-talks') }}">Lightning Talks</a></li>
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/unconference') }}">Unconference</a></li>
{% if not flagisvirtual %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/sponsor-expo') }}">Sponsor Expo</a></li>
{% endif %}
{% if flaghashike %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/hike') }}">Hike</a></li>
{% endif %}
Expand Down Expand Up @@ -62,13 +61,17 @@
<ul class="uk-nav uk-navbar-dropdown-nav">
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/venue') }}">Venue</a></li>
{% if not flagisvirtual %}
{% if flagspeakersannounced %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/visiting') }}">Visiting {{ city }}</a></li>
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/attendee-guide') }}">Attendee Guide</a></li>
{% endif %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/health') }}">Health and Safety Policy</a></li>
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/volunteer') }}">Volunteer Info</a></li>
{% endif %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/code-of-conduct') }}">Code of Conduct</a></li>
{% if flagspeakersannounced %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/team') }}">Meet the Team</a></li>
{% endif %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/contact') }}">Contact us</a></li>
{% if flaghasbadgeflair %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/badge-flair') }}">Badge Flair Contest</a></li>
Expand All @@ -93,7 +96,13 @@
</ul>
</li><!--- Parent element with it's children -->

<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/news') }}">News</a></li>
<li>
<ul class="uk-navbar-nav">
<li>
<a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/news') }}">News</a>
</li>
</ul>
</li>

{% if flagcfp %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/cfp') }}" class="uk-button uk-button-ghost uk-text-uppercase">Speak</a></li>
Expand Down
13 changes: 9 additions & 4 deletions docs/_templates/2025/menu-mobile.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,9 @@
<li class="uk-parent">
<a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/schedule') }}">Program</a>
<ul class="uk-nav-sub">
{% if flaghasschedule %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/schedule') }}">Schedule</a></li>
{% endif %}
{% if flagspeakersannounced %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/speakers') }}">Speakers</a></li>
{% endif %}
Expand All @@ -14,9 +16,6 @@
{% endif %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/lightning-talks') }}">Lightning Talks</a></li>
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/unconference') }}">Unconference</a></li>
{% if not flagisvirtual %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/sponsor-expo') }}">Sponsor Expo</a></li>
{% endif %}
{% if flaghashike %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/hike') }}">Hike</a></li>
{% endif %}
Expand Down Expand Up @@ -47,13 +46,17 @@
<ul class="uk-nav-sub">
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/venue') }}">Venue</a></li>
{% if not flagisvirtual %}
{% if flagspeakersannounced %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/visiting') }}">Visiting {{ city }}</a></li>
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/attendee-guide') }}">Attendee Guide</a></li>
{% endif %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/health') }}">Health and Safety Policy</a></li>
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/volunteer') }}">Volunteer Info</a></li>
{% endif %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/code-of-conduct') }}">Code of Conduct</a></li>
{% if flagspeakersannounced %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/team') }}">Meet the Team</a></li>
{% endif %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/contact') }}">Contact us</a></li>
{% if flaghasbadgeflair %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/badge-flair') }}">Badge Flair Contest</a></li>
Expand All @@ -70,7 +73,9 @@
</ul>
</li>

<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/news') }}">News</a></li>
<li class="uk-parent">
<a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/news') }}">News</a>
</li>

{% if flagcfp %}
<li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/cfp') }}"
Expand Down
5 changes: 4 additions & 1 deletion docs/conf/portland/2025/contact.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,12 @@ If you have any questions or concerns,
the best way to reach us is via email.
You can email us at {{ shortcode }}@writethedocs.org.

{% if flagspeakersannounced %}

Press Kit
---------

If you're looking to get logos or other assets,
you can find them on our :doc:`/conf/{{shortcode}}/{{year}}/press-kit` page.
you can find them on our :doc:`/conf/{{shortcode}}/{{year}}/press-kit` page.

{% endif %}
101 changes: 101 additions & 0 deletions docs/conf/portland/2025/convince-your-manager.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
---
template: {{year}}/generic.html
og:image: _static/conf/images/headers/{{shortcode}}-{{year}}-opengraph.jpg
---

# Convince Your Manager

Do you need help justifying why your manager should send you to Write the Docs? Do you need help convincing your community to submit a Writing Day Project? Don’t worry – you’re not alone. Based on the experiences of some of our previous attendees, we’ve put together two sample emails and a list of resources below. Feel free to adapt and share with your employer and community to convince them that there are many benefits of attending!

## Sample Email #1

### Convince your manager to send you to Write the Docs

Remember to change the things in [brackets]!

*FROM: [your name]*

*TO: [your employer or manager’s name]*

*SUBJECT: Professional Development: Documentation Community Conference*

*I’d like to attend Write the Docs Portland from May 4-6, 2025. This three-day event explores the art and science of documentation, and covers a diverse range of topics related to documentation in the software industry.*

*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.*

*Costs:*

- *[Conference ticket](https://www.writethedocs.org/conf/portland/2025/tickets/) - $650*

*Benefits:*

- *Discovering solutions to problems I’m facing at work*
- *Exposure to the latest ideas, techniques, and tools for software docs*
- *Opportunity to learn from the best doc teams in the industry*
- *Building professional connections with other documentarians*

*Thanks in advance, [your name]*

### Corporate Resources

When discussing how to pitch the conference, a few generally helpful tips emerged:

- Highlight specific talks that relate to ongoing projects at work (after talk line up has been announced).
- If your company is looking to hire another documentarian, the networking is an excellent resource.
- Attending raises the visibility of your company in the community.
- Establishes your team's reputation for caring about their docs.
- Share info about previous conferences. View the [main page overview](https://www.writethedocs.org/conf/portland/2025/) explaining Write the Docs, history, and schedule overview.

## Sample Email # 2

### Convince your manager or community to participate in Writing Day



Remember to change the things in [brackets]!

*FROM: [your name]*

*TO: [your employer or community lead's name]*

*SUBJECT: Docs hackathon: Documentation Community Conference*

*I’d like to attend Write the Docs Portland from May 4-6, 2025. This three-day event explores the art and science of documentation, and covers a diverse range of topics related to documentation in the software industry. I am particularly interested in leading a project at Writing Day. I believe this event can positively impact our project and community.*

*Writing Day is modeled after the concept of “code sprints” or “hackathons”, which are common in open-source conferences. The primary goal is to bring interesting individuals into the same room and have them work towards a shared goal; in this case the goal is creating or improving documentation or other related projects.*

*Costs:*

- *[Conference ticket](https://www.writethedocs.org/conf/portland/2025/tickets/) - $650*

*Writing Day Benefits:*

- *Introduce our project and community to a new audience and demographic in our industry*
- *Get highlighted as a project in the conference blog and announcements (must submit online by April 17, 2025)*
- *Onboard documentation enthusiasts to increase the likelihood of post-conference contributions*
- *Strategically tackle documentation tickets and requests*
- *Update existing documentation
Peer review new and existing documentation*

*Conference Benefits:*

- *Exposure to the latest ideas, techniques, and tools for software docs*
- *Opportunity to learn from the best doc teams in the industry*
- *Building professional connections with other documentarians*

*Bringing our project to Writing Day benefits us as a community. It gives us the opportunity to improve our documentation and create a more inclusive project.*

*Thanks in advance, [your name]*

### Writing Day Resources

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)
- 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.
- Review the [tips for leading a project](https://www.writethedocs.org/conf/portland/2025/writing-day/#lead-a-project) at Writing Day.
- Share info about previous conferences. View the [main page overview](https://www.writethedocs.org/conf/portland/2025/) explaining Write the Docs, history, and schedule overview.
Loading

0 comments on commit 7c7c098

Please sign in to comment.