Speaker info refactor

docs/_data/portland-2025-config.yaml

@@ -164,6 +164,7 @@ about:
   attendees: 400
   social_venue:  Jupiter NEXT, 900 E Burnside St (2nd floor)
   venue: Revolution Hall
+  venue_address: Revolution Hall, 1300 SE Stark St, Portland, Oregon 97214
   photos: TBD
   mainroom: Main stage
   unconfroom: Library & Astoria room (1st floor)
@@ -174,6 +175,7 @@ cfp:
   url: "https://pretalx.com/wtd-portland-2025/cfp" # Open October 6 (Mon) -> 9 weeks to submit
   ends: "January 21, 2025"                         # (Mon) 1 week, to review. It'll take a little longer to announce
   notification: "February 4, 2025"                 # (Mon) 8 weeks to write and prepare
+  speaker_tickets_by: April 04, 2025                  # Approx 4 weeks before
   slides_by: "April 28, 2025"                      # (Mon) 1 week before
   preview: "TODO"                                  # Preview URL TODO
 

docs/_data/schema-config.yaml

@@ -163,6 +163,7 @@ sponsor-detail:
 about-details:
   summary: str(required=False)
   venue: str(required=False)
+  venue_address: str(required=False)
   attendees: any(int(), str())
   mainroom: str(required=False)
   unconfroom: str(required=False)
@@ -179,6 +180,7 @@ cfp-details:
   video_by: str(required=False)
   slides_by: str(required=False)
   info_by: str(required=False)
+  speaker_tickets_by: str(required=False)
   gifts_by: str(required=False)
   preview: str(required=False)
 

docs/_templates/2025/menu-desktop.html

@@ -66,6 +66,7 @@
                 <li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/attendee-guide') }}">Attendee Guide</a></li>
                 <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+'/virtual') }}">Virtual Attendance</a></li>
             <li><a href="{{ pathto('conf/'+shortcode+'/'+year_str+'/code-of-conduct') }}">Code of Conduct</a></li>

docs/conf/portland/2025/speaker-info.rst

@@ -0,0 +1,96 @@
+:template: {{year}}/generic.html
+:orphan:
+:og:image: _static/conf/images/headers/{{shortcode}}-{{year}}-opengraph.jpg
+
+
+Speaker Info
+============
+
+.. contents::
+    :local:
+    :depth: 1
+
+Essential info
+--------------
+
+Location
+    {{ about.venue_address }}
+
+Date
+    {{ date.short }}
+
+Projector specs
+    1920 x 1200 resolution at 60Hz via HDMI, DisplayPort or VGA
+
+Talk length
+    30 minutes of presentation followed by 10 mins moderated Q&A
+
+Microphones
+    We have both over ear (preferred) and handheld
+
+Pre-conference Schedule
+-----------------------
+
+**{{cfp.ends}}**
+    Call for Proposal ends.
+
+**{{cfp.notification}}**
+    We'll let you know whether your proposal was accepted, and ask for some supplementary information about you.
+    Make sure to confirm your talk as soon as you get the email, and update your pronouns, photo, name pronunciation, and bio in Pretalx.
+
+**{{cfp.speaker_tickets_by}}**
+    Register your free speaker ticket with dietary preferences (we'll drop you a ticket link beforehand).
+
+**{{cfp.slides_by}}**
+    Upload a copy of your slides so our human captioners can prepare for your talk. We'll email you an upload link beforehand.
+
+**{{date.short}}**
+    Folks start giving talks on stage!
+
+Conference Schedule
+--------------------
+
+Your speaker tech check will be directly before the morning or afternoon session you are speaking at, bring the laptop you'll be using to present.
+
+For example if you speak at 10:00am on Tuesday, your tech will be at 8:00am on Tuesday. Meet in front of the main stage.
+
+View the full `attendee schedule <https://www.writethedocs.org/conf/portland/2025/schedule/>`__.
+
+SUNDAY
+~~~~~~
+
+There are no speaker-specific requirements this day but we encourage you to join us for Writing Day and our Welcome Reception.
+
+MONDAY
+~~~~~~
+
+- 8:00-8:30am: Morning Speaker tech checks at main stage
+- 9:00am-11:55am: Speaker Talks
+- 11:55am-12:25pm: Afternoon Speaker tech checks at main stage
+- 1:45pm-4:40pm: Speaker Talks
+
+TUESDAY
+~~~~~~~
+
+- 8:00am-8:30am: Morning Speaker tech checks at main stage
+- 9:00-12:05pm: Speaker Talks
+- 12:05-12:25pm: Afternoon Speaker tech checkss at main stage
+- 2:00-3:50pm: Afternoon Speaker Talks
+
+Speaking Tips
+-------------
+
+{% include "conf/portland/speaking-tips-2025.rst" %}
+
+Media Kit
+----------
+
+Share with your communities that you are speaking at the conference.
+Download copy and graphics from our `Speaker Media Kit <https://drive.google.com/drive/folders/1gVmIjX5hMklJiFitAllukzENA4SIBic9?usp=sharing>`__.
+
+This includes:
+
+- Social media copy
+- "I am a speaker" graphic
+- Individual graphic
+- Event graphic

docs/include/conf/portland/speaking-tips-2025.rst

@@ -0,0 +1,34 @@
+Are you giving a talk at this year's in-person {{city}} Write the Docs? Great! Here are a
+few things that may help you plan for preparing and presenting your talk.
+
+- The more you practice your talk, the more comfortable you'll be when presenting. In addition to practicing by yourself, we strongly recommend you do it in front of at least one other human.
+- If you haven't spoken before, your time will likely be shorter than when you are practicing.
+- Make sure your slides are high contrast.
+- Include where you want people to find you (e.g., LinkedIn, Bluesky) so people can properly attribute your brilliance.
+
+If you want to get some of that sweet internet buzz for your talk, we use the #writethedocs hashtag throughout the event.
+
+Presentation Resources
+~~~~~~~~~~~~~~~~~~~~~~
+
+Here are some great resources for new speakers:
+
+- `An Introvert's Guide to Better Presentations <https://medium.com/@mathowie/an-introverts-guide-to-better-presentations-be7e772b2cb5>`__
+- `On Conference Speaking <https://hynek.me/articles/speaking/>`__
+- `Public Speaking for the Terrified...errr, Passionate First Timer <https://sardoodle.substack.com/p/public-speaking-for-the-terrifiederrr>`__
+- `How to prepare a conference talk <http://wunder.schoenaberselten.com/2016/02/16/how-to-prepare-and-write-a-tech-conference-talk/>`__
+
+Inclusive Language
+~~~~~~~~~~~~~~~~~~~
+
+- We strongly encourage all speakers to check and double-check their talks for any language that might be discriminatory or offensive.
+- This includes needlessly gendered language. **For example, we actively avoid using 'you guys'.**
+- Avoid ageist language (please no 'so easy my grandma could do it!' anecdotes), and any other language that's presumptive about or exclusive towards the variety of folks who will be in the audience.
+- We know there's a ton of nuance and complexity here, just do your best to be aware of and sensitive about your language choices! If you have any doubts about any of your language, feel free to ask us in advance.
+
+Good resources on this include:
+
+- `The 18F Guide to Inclusive Language <https://content-guide.18f.gov/inclusive-language/>`__
+- `The Responsible Communication Style Guide <https://rcstyleguide.com/>`__
+- `GDS design principles <https://www.gov.uk/guidance/government-design-principles#this-is-for-everyone>`__
+

requirements.txt

@@ -1,7 +1,7 @@
 Sphinx==5.3.0
 
 # make livehtml support
-sphinx_autobuild==2024.10.3
+sphinx_autobuild==2021.3.14
 
 # Markdown support
 myst-parser==0.18.0
@@ -11,7 +11,7 @@ ablog==0.10.31  # pyup: ignore
 
 # Sphinx (checked with 4.3) requires docutils=<0.18
 docutils==0.17.1   # pyup: <0.18
-PyYAML==6.0.2 
+PyYAML==6.0.2
 pytz==2024.2
 
 # Additional libraries
@@ -33,3 +33,5 @@ Werkzeug==0.16.1 # pyup: <1.0
 sphinx-notfound-page==0.8
 # For fancy twitter previews
 sphinxext-opengraph==0.9.1
+# For social cards
+matplotlib==3.7.5