From 3320d9bd8ec8db76d47ac0b34738c7abcb9b3918 Mon Sep 17 00:00:00 2001 From: Sasha Romijn Date: Thu, 26 Sep 2024 15:54:11 +0000 Subject: [PATCH 1/7] Add script to generate Venueless links for tickets and attach them in Tito (#2186) * Add script to generate Venueless links for tickets and attach them in Tito * Fix traits --- docs/_scripts/venueless2tito.py | 108 ++++++++++++++++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 docs/_scripts/venueless2tito.py diff --git a/docs/_scripts/venueless2tito.py b/docs/_scripts/venueless2tito.py new file mode 100644 index 000000000..b07ac4e02 --- /dev/null +++ b/docs/_scripts/venueless2tito.py @@ -0,0 +1,108 @@ +# This script does the following: +# - Find all completed attendees in tito +# - Filter for ones that have no current venueless link +# - Connect and auth to the venueless websockets API +# - For each ticket that has no venueless link yet: +# - Determine traits based on ticket type +# - Also set the tito ticket reference as a trait to allow permission finetuning later +# - Get a login link from Venueless for these traits +# - Save the link in tito +# +# To use: +# - Set VENUELESS_JWT env to your venueless JWT token (get from `curl -D - your-login-URL`, or browser) +# - Set TITO_TOKEN to your tito token from https://id.tito.io/api-access-tokens +# - Update the settings block below to match your event + + +import json +import os +from pathlib import Path + +import sys + +import requests +from websockets.sync.client import connect + +docs_root = str(Path(__file__).resolve().parents[1]) +sys.path.append(docs_root) + +############################################################################### +# Settings + +TITO_EVENT = "write-the-docs-atlantic-2024" +VENUELESS_PUBLIC_URL = "https://writethedocs.venueless.events/" # include trailing / +VENUELESS_EVENT_SLUG = "wtd24" +TICKET_NAME_TO_TRAIT = { + "staff": ["staff"], + "speaker": ["speaker"], + "sponsor": ["sponsor"], +} +DEFAULT_TRAITS = ["attendee"] + +############################################################################### + +assert VENUELESS_PUBLIC_URL[-1] == "/" + +TITO_TOKEN = os.environ.get("TITO_TOKEN") +if not TITO_TOKEN: + print("Error: TITO_TOKEN not found in environment variables.") + sys.exit(1) + +VENUELESS_JWT = os.environ.get("VENUELESS_JWT") +if not VENUELESS_JWT: + print("Error: VENUELESS_JWT not found in environment variables.") + sys.exit(1) + +headers = {"Authorization": f"Token token={TITO_TOKEN}", "Accept": "application/json"} + +hello_response = requests.get("https://api.tito.io/v3/hello", headers=headers) +assert hello_response.json()["authenticated"] + +pending_tickets = [] + +# NOTE: in tito UI, this is called an attendee +tickets_response = requests.get( + f"https://api.tito.io/v3/writethedocs/{TITO_EVENT}/tickets", + params={"page[size]": 1000, "search[states][]": "complete", "expand": "release"}, + headers=headers, +) +for ticket in tickets_response.json()["tickets"]: + ticket_slug = ticket["slug"] + ticket_reference = ticket["reference"] + venueless_meta = ticket.get("metadata").get("venueless") if ticket.get("metadata") else None + + # "release" is the API term for what the UI calls "ticket" + traits = TICKET_NAME_TO_TRAIT.get(ticket["release"]["title"].lower(), []).copy() + traits += DEFAULT_TRAITS + traits.append(ticket_reference) + + is_staff = ticket["release"]["title"] == "Staff" + print(f'Found ticket {ticket["name"]}: {ticket_reference=} {traits=} {venueless_meta=} {is_staff=}') + if not venueless_meta and is_staff: + pending_tickets.append((ticket_slug, traits)) + +VENUELESS_WSS_URL = f"{VENUELESS_PUBLIC_URL.replace('https', 'wss')}ws/world/{VENUELESS_EVENT_SLUG}/" + +with connect(VENUELESS_WSS_URL) as ws_client: + venueless_rq_count = 1 + ws_client.send(json.dumps(["authenticate", {"token": VENUELESS_JWT}])) + message = json.loads(ws_client.recv()) + assert message[1]["user.config"] + + for ticket_slug, traits in pending_tickets: + ws_client.send( + json.dumps(["world.tokens.generate", venueless_rq_count, {"number": 1, "days": 90, "traits": traits}]) + ) + message = json.loads(ws_client.recv()) + assert message[0] == "success" + assert message[1] == venueless_rq_count + token = message[2]["results"][0] + venueless_url = f"{VENUELESS_PUBLIC_URL}login/{token}" + venueless_rq_count += 1 + + tickets_update_response = requests.patch( + f"https://api.tito.io/v3/writethedocs/{TITO_EVENT}/tickets/{ticket_slug}", + json={"metadata": json.dumps({"venueless": venueless_url})}, + headers=headers, + ) + print(f"Updated venueless link for ticket {ticket_slug}: {venueless_url}") From 5ef9eecc1301313a7afdb5da5ac505ca8af1fafe Mon Sep 17 00:00:00 2001 From: Aaron Collier Date: Fri, 4 Oct 2024 15:42:48 +0200 Subject: [PATCH 2/7] Add October 2024 newsletter (#2239) * Add October 2024 newsletter * Link to YouTube playlist * Improvements from review * Clarifications after review Co-authored-by: Sam --------- Co-authored-by: Sam --- docs/blog/newsletter-october-2024.rst | 134 ++++++++++++++++++++++++++ docs/topics.rst | 4 + 2 files changed, 138 insertions(+) create mode 100644 docs/blog/newsletter-october-2024.rst diff --git a/docs/blog/newsletter-october-2024.rst b/docs/blog/newsletter-october-2024.rst new file mode 100644 index 000000000..869f7ab34 --- /dev/null +++ b/docs/blog/newsletter-october-2024.rst @@ -0,0 +1,134 @@ +:og:image: https://www.writethedocs.org/_static/logo-opengraph.png + +.. post:: October 3, 2022 + :tags: newsletter + +######################################## +Write the Docs Newsletter – October 2024 +######################################## + +Hello hello, wonderful documentarians! I hope you all are able to find sources of inspiration around you. The ideas coming from the Write the Docs community and conferences recently have provided me with hope for the future. + +Our most recent conference was the Atlantic 2024 conference. If you missed it, or just want to revisit, check out the `videos from the conference `__ and the `sketchnotes of every talk `__. And once you've seen those, check out the next conference, Australia 2024, which just announced its `speakers and full schedule `__. Be sure to grab a ticket for November 28–29 in Melbourne if you can. + +In other community news, the 2024 WTD Documentation Salary Survey -- our 6th annual survey -- will be open for submissions very soon! We're implementing a couple of frequently requested usability improvements and are still ironing out a few issues, but keep an eye on the `survey website `__ and follow Write the Docs on Twitter and LinkedIn, where it will be announced as soon as it's ready. + +Relatedly, the Write the Docs job board has been replaced. In its place, we have a `new sponsorship opportunity `__ for for companies looking to hire documentarians. We're still hoping to provide useful information about job openings, just closer to where our community is. + +In the newsletter this month, we have articles on dealing with feedback in large volumes, how to handle freelance work, standards for using callouts, and whether to keep docs in code. Hope you'll find something for you! + +------------------------------ +Managing mountains of feedback +------------------------------ + +Resolving feedback on documentation can mean anything from making straightforward updates to undertaking a substantial investigation and revision, but it always takes time away from documenting new product functionality. If you can't hire more documentarians to keep up with both addressing feedback and writing new docs, you can try these ideas. + +* Tag feedback tickets with information about their required effort so that writers can take on the quick fixes as a mental break from more involved work. Schedule bigger tickets and critical issues alongside product work. + +* If it works with your release cadence, schedule time each month or quarter for a "bug bash" devoted entirely to addressing docs feedback. + +* Filter feedback through customer-facing colleagues to identify high-quality requests for docs changes. When appropriate, consider diverting tickets that describe product problems, such as a confusing user interface or functionality, to other teams as requested improvements. + +* If you have a customer knowledge base that answers basic questions about the product, try to route some feedback to the team that maintains it. Creating standard responses for the most common issues can also reduce the time everyone spends on repetitive feedback. + +It's also possible that much of the feedback you receive isn't worth addressing at all. If you can't automate the process for reviewing feedback, it takes a lot of time. And then, revising something trivial may come at the cost of writing a new topic that could really help someone. Feedback from an engaged user base that feels a sense of ownership is typically very useful, but otherwise, the feedback quality may not be worth the effort you spend evaluating it. + +------------------------------------- +Working as a contractor or freelancer +------------------------------------- + +Some documentarians consider contracting or freelancing while job hunting. In the `#freelance channel `__, a former employee asked about taking on a client. + +**What rate to use?** + +Rates for technical writers vary widely and depend on many factors. + +* The domain and the audience: In software, developer documentation prompts the highest rates; end-user documentation rates are usually lower. Hardware-associated documentation rates may be lower. Specialist documentation (such as scientific or medical) may command higher rates. +* The geographical location: In the US, tech hubs, major cities, and the coasts have higher rates. In non-tech industries and non-coastal areas, rates tend to be lower. Rates vary by country and relate to cost of living in a particular area. +* The type of work requested: Charge less for minor editing. Rewriting or creating new content costs more. Re-organizing content (information architecture) or, in a docs-as-code environment, setting up and working with a tool chain would command higher rates. +* Your skills and experience: Highly skilled and experienced professionals can ask for higher rates. + +To calculate an hourly rate (in the US) determine the salary for an equivalent position, divide that by 52x40, and then double or triple that to compensate for benefits. Check job postings and the `2023 WTD Salary Survey `_ for salaries. + +**Can I assume that the client pays taxes?** + +If you’re working as a W2 contractor in the US, the agency takes out federal taxes. As a freelancer in the US (1099), you pay all taxes. In other countries, check your local tax requirements, which vary widely. + +**How often will I get paid?** + +As a contractor, the pay period depends on the agency. As a freelancer, your contract defines the pay period. Some freelancers bill based on the project (milestones); some calculate invoices based on an hourly rate. + +**What can I consider billable hours?** + +As a contractor working on site, you normally bill for hours on site based on your contract. As a freelancer working off site, you bill whenever you work on the project. In general, you don't get overtime unless it’s in your contract. + +--------------------------------------- +Using callouts/admonitions in tech docs +--------------------------------------- + +When it comes to creating clear and effective technical documentation, knowing when to use callouts and admonitions (sections, often boxes, that stand out from the surrounding text) and avoiding overuse is key to creating user-friendly content. They can highlight important information and ensure your documentation remains accessible and easy to navigate. + +Some style guides follow a tiered system to ensure proper use: + +- Tip: Helpful advice that can make tasks easier but isn’t critical. +- Note: Relevant but non-essential information that adds context but doesn’t affect the task’s outcome. +- Important: Information that, if missed, could lead to frustration or additional work. +- Warning: Critical details about data loss or security risks, where overlooking the warning could cause significant problems. + +The key is moderation. Too many individual notes, tips, or warnings can cause “admonition fatigue” and lead to readers skipping over important information. When deciding between separated content or inline text, weigh the impact. If it’s crucial and might be missed, make it stand out. Otherwise, integrating it into the main body ensures smoother flow and readability. + +By setting clear guidelines and using these tools purposefully, you can help users focus on what’s most important—without overwhelming them. + +------------------------------------- +Should APIs be documented with code? +------------------------------------- + +A recent question about documenting APIs in code in the `#documenting-apis channel `__ met with some strong pushback. Someone felt that putting documentation in code (meaning the code used to generate the product) was the last thing documentarians should want. Others defended the practice. + +The reasons given for separating docs and code included the idea that because docs in code relies on automated tools, their syntax is much less human-readable. It was also noted that modifying code might require specialized skills and privileges that some documentarians don't have. Having to compile and test an entire code source for a small docs change was also viewed as a barrier to entry, whereas a separate reference file means documentarians can work independently. + +The responses focused on the benefits of automatic generation and how it meant the reference was much more likely to stay up to date, especially compared to maintaining API definitions by hand. They celebrated the dependence on the code. It was also seen as a way to meet developers where they already are and so lower their barriers to contributing. People advocating for docs in code also said they keep all formatting in code to a minimum, with anything more complex in a guide separate from the API reference. + +In the end, almost everyone agreed that the best solution is a single OpenAPI description that acts as a single source of truth for both the product and the docs, focusing on API design first. If this isn't possible, it comes down to your circumstances. If you and your fellow documentarians are code-literate and have access to the code, you may find it best to update API docs in the code itself. If making changes to the product code is difficult, you may need to make modifications to a generated reference or even mirror code changes in your own OpenAPI description. + +---------------- +From our sponsor +---------------- + +This month’s newsletter is sponsored by `GitBook `_: + +------ + +.. image:: /_static/img/sponsors/gitbook.png + :align: center + :width: 75% + :target: https://www.gitbook.com/?utm_campaign=product-docs&utm_medium=email&utm_source=write_the_docs&utm_content=newsletter + :alt: GitBook logo + ++++++++++++++++++++++++++++++++++ +Product docs your users will love ++++++++++++++++++++++++++++++++++ + +GitBook has everything you need to create beautiful docs for your users — so you don’t have to build your own editing tools, CMS, website, and more. You can just focus on writing great content. + +GitBook’s branch-based Git workflow encourages your whole team to collaborate by creating a branch, requesting a review, and merging when ready. It’s a flow your developers already know and love — and they can even edit your docs in their code editor using Git Sync. + +That’s all backed up by AI that lets your users find what they need fast, publishing settings that put you in control of who can access your docs, and internal documentation for your own team. + +Sign up today and `get started for free `__! + +------ + +*Interested in sponsoring the newsletter? Take a look at our* `sponsorship prospectus `__. + +---------------- +Events coming up +---------------- + +- 3 Oct, 17:30 CDT (Austin, USA): `Write the Docs ATX Social Event @ Cherrywood Coffeehouse `__ +- 4 Oct, 08:30 EDT (East Coast Quorum, USA): `Social Hour for Documentarians `__ +- 10 Oct, 12:00 AEDT (Australia): `(Virtual) From Markdown to Mic Drop: A Tech Writer's Guide to Presentations `__ +- 16 Oct, 19:00 EDT (Toronto, Canada): `Write the Docs Toronto `__ +- 18 Oct, 08:30 EDT (East Coast Quorum, USA): `Social Hour for Documentarians `__ +- 24 Oct, 18:00 BST (London, United Kingdom): `From one to many - Building a documentation team `__ +- 1 Nov, 08:30 EDT (East Coast Quorum, USA): `Social Hour for Documentarians `__ diff --git a/docs/topics.rst b/docs/topics.rst index 61bce67d7..a0ae5b9c0 100644 --- a/docs/topics.rst +++ b/docs/topics.rst @@ -82,6 +82,7 @@ Code samples Formatting ~~~~~~~~~~ +- |:newspaper:| `Using callouts/admonitions in tech docs `__ - |:newspaper:| `What to do about text wrapping `__ - |:newspaper:| `Number formatting in data tables `__ - |:newspaper:| `Formatting and updating images and screenshots `__ @@ -140,6 +141,7 @@ Task-based writing API docs ~~~~~~~~ +- |:newspaper:| `Should APIs be documented with code? `__ - |:newspaper:| `API design with docs in mind `__ - |:movie_camera:| `Shuffle ball change: Sashay your way to clearer API documentation `__ - |:movie_camera:| `Write the API docs before the API exists `__ @@ -271,6 +273,7 @@ Maintenance Jobs and careers ---------------- +- |:newspaper:| `Working as a contractor or freelancer `__ - |:newspaper:| `Should Technical Communication Be Its Own Department? `__ - |:newspaper:| `What to do after surviving layoffs `__ - |:newspaper:| `Knowledge transfer for documentarians `__ @@ -605,6 +608,7 @@ User feedback Gathering it and acting on it. +- |:newspaper:| `Managing mountains of feedback `__ - |:newspaper:| `Collecting helpful user feedback `__ - |:movie_camera:| `Customer Feedback is the Fuel in our Engine `__ - |:newspaper:| `Gathering documentation feedback `__ From 43b1dc2ac870b4a61fec0c0d8de640077fc70023 Mon Sep 17 00:00:00 2001 From: Eric Holscher <25510+ericholscher@users.noreply.github.com> Date: Sat, 5 Oct 2024 19:41:34 -0700 Subject: [PATCH 3/7] fix newsletter date --- docs/blog/newsletter-october-2024.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/blog/newsletter-october-2024.rst b/docs/blog/newsletter-october-2024.rst index 869f7ab34..5cc4de82c 100644 --- a/docs/blog/newsletter-october-2024.rst +++ b/docs/blog/newsletter-october-2024.rst @@ -1,6 +1,6 @@ :og:image: https://www.writethedocs.org/_static/logo-opengraph.png -.. post:: October 3, 2022 +.. post:: October 3, 2024 :tags: newsletter ######################################## From b44c3e2a897d4196cbb1b37093f57ac3c3a5ead3 Mon Sep 17 00:00:00 2001 From: Sasha Romijn Date: Mon, 7 Oct 2024 11:16:26 +0200 Subject: [PATCH 4/7] Atlantic thank you post and video publish (#2237) --- docs/_data/atlantic-2024-config.yaml | 34 ++--- .../atlantic/2024/news/thank-you-recap.rst | 122 ++++++++++++++++++ 2 files changed, 139 insertions(+), 17 deletions(-) create mode 100644 docs/conf/atlantic/2024/news/thank-you-recap.rst diff --git a/docs/_data/atlantic-2024-config.yaml b/docs/_data/atlantic-2024-config.yaml index 376b572fb..2e919d937 100644 --- a/docs/_data/atlantic-2024-config.yaml +++ b/docs/_data/atlantic-2024-config.yaml @@ -33,25 +33,25 @@ buttons: # link: /sponsors/prospectus #- text: Submit a Talk # link: /cfp - - text: See the talks! - link: /speakers - - text: See the Schedule! - link: /schedule +# - text: See the talks! +# link: /speakers +# - text: See the Schedule! +# link: /schedule # - text: Watch the Live Stream # link: /livestream - # - text: See the sketchnotes - # link_absolute: https://www.flickr.com/photos/writethedocs/albums/72157720128594755 - #- text: Watch the videos! - # link_absolute: https://youtube.com/playlist?list=PLZAeFn6dfHplddJfvbke1bpUzZGozb2Yj&si=AOwsHHgwGEXqbUm0 + - text: Read the recap + link_absolute: https://www.writethedocs.org/conf/atlantic/2024/news/thank-you-recap/ + - text: Watch the videos! + link_absolute: https://www.youtube.com/playlist?list=PLZAeFn6dfHpn8IckCiREggN0f9oWEMomW bottom: # - text: Welcome to our conference # link: /news/welcome - - text: See the Schedule! - link: /schedule +# - text: See the Schedule! +# link: /schedule # - text: Sponsor the conference # link: /sponsors/prospectus - - text: See the talks! - link: /speakers +# - text: See the talks! +# link: /speakers # - text: Buy a Ticket! # link: /tickets # - text: Prepare with the Welcome Wagon @@ -60,10 +60,10 @@ buttons: # link: /schedule # - text: Watch the Live Stream # link: /livestream - # - text: Browse the photos - # link_absolute: https://www.flickr.com/photos/writethedocs/albums/72157691507514803 - #- text: Watch the videos! - # link_absolute: https://youtube.com/playlist?list=PLZAeFn6dfHplddJfvbke1bpUzZGozb2Yj&si=AOwsHHgwGEXqbUm0 + - text: Read the recap + link_absolute: https://www.writethedocs.org/conf/atlantic/2024/news/thank-you-recap/ + - text: Watch the videos! + link_absolute: https://www.youtube.com/playlist?list=PLZAeFn6dfHpn8IckCiREggN0f9oWEMomW tickets: concierge: @@ -193,7 +193,7 @@ flagspeakersannounced: True flagrunofshow: False flaghasschedule: True flaghasshirts: False -flagvideos: False +flagvideos: True flaglivestreaming: False flagpostconf: True diff --git a/docs/conf/atlantic/2024/news/thank-you-recap.rst b/docs/conf/atlantic/2024/news/thank-you-recap.rst new file mode 100644 index 000000000..befc62082 --- /dev/null +++ b/docs/conf/atlantic/2024/news/thank-you-recap.rst @@ -0,0 +1,122 @@ +:template: {{year}}/generic.html +:banner: _static/conf/images/headers/venue.png + +.. post:: Oct 3, 2024 + :tags: recap, thanks, {{year}}, {{shortcode}}-{{year}} + +Conference highlights +===================== + +Hey everyone, + +Our team is now emerging from the post-conference recovery period, and we wanted to send out a quick message to thank everyone for helping to make our conference such a success. +We appreciate everyone who makes the conference possible: speakers, sponsors, organizers, volunteers, and attendees alike! + +Conference recap +---------------- + +At **just over 250 attendees** this conference was a welcoming and friendly event. +This was our second Atlantic conference, aimed at attendees from Europe, Africa, US East Coast and parts of South America. We had attendees from 29 countries all over the world. + +We had the usual mix of talks on the main stage, along with moderated Q&A, lightning talks, unconference sessions, writing day, and a sponsor expo, similar to previous virtual conferences. + +Talk videos +----------- + +`Videos of the talks`_ are now available on YouTube. This includes all conference talks and Q&A, as well as the lightning talks. +You can also subscribe to our `YouTube channel`_ so you don’t miss any talk videos from our conferences. + +Thanks again to all our presenters, moderators, and folks who asked wonderful questions! +Huge thanks also to `Bart at Work`_ for handling the A/V production on our event, it was flawless once again this year. + +.. _Videos of the talks: https://www.youtube.com/playlist?list=PLZAeFn6dfHpn8IckCiREggN0f9oWEMomW +.. _Bart at Work: https://www.bartatwork.com/ +.. _YouTube channel: https://www.youtube.com/writethedocs + +Sketchnotes +----------- + +We’re excited to share the `full resolution sketchnotes`_ from each talk. You are welcome to use them for non-commercial purposes, like including them in your conference write up ;) + +Thanks to `Dennis Dawson`_ for doing them this year! + +.. _full resolution sketchnotes: https://www.flickr.com/photos/writethedocs/albums/72177720320644083 +.. _Dennis Dawson: https://dennissdawson.wixsite.com/mr--dawson/portfolio + +Shirts still on sale +-------------------- + +If you want a souvenir from this year's conference, our `Write the Docs Atlantic 2024 Pop-Up Shop `_ is still open until October 31st! +We have loose and fitted options from different fabrics, and you can choose the size and cut you want. + +The campaign will run in 3-day batches, with shipping from the USA or Europe. + +Upcoming conferences +-------------------- + +Our next event is the `Australia conference`_ on **Nov 28-29, 2024**. +We’re also looking for more sponsors to make our other events just as magical as this year’s Atlantic event. You can see all our `sponsorship options`_ on our website. + +Write the Docs `Portland 2025`_, will take place on May 4-6 in Portland, Oregon. +We plan to open the Call for Papers later in the year. + +.. _Australia conference: https://www.writethedocs.org/conf/australia/2024/ +.. _sponsorship options: https://www.writethedocs.org/sponsorship/ +.. _Portland 2025: https://www.writethedocs.org/conf/portland/2025/ + +Write the Docs Slack +-------------------- + +Our Slack network keeps on growing. Our #general channel in particular has been extra busy in the days and weeks leading up to the conference, and we hope that y’all continue the conversations throughout the year. If you haven’t joined, now is the time! +Check out the `Write the Docs Slack`_. + +.. _Write the Docs Slack: http://www.writethedocs.org/slack/ + +Write the Docs Newsletter +------------------------- + +Our `monthly newsletter`_ is the other place to keep track of everything that is happening with the community. +Subscribe to make sure you hear about all the conferences, meetups, job postings, and summaries of relevant conversations in our Slack. + +.. _monthly newsletter: http://writethedocs.org/newsletter/ + +Local Meetups +------------- + +We hope you continue to `build your local or online communities`_ and keep in touch with other documentarians. +We have a number of meetups in cities across the country, and if you don’t see your city listed consider `starting`_ a meetup! + +.. _build your local or online communities: http://www.writethedocs.org/meetups/ +.. _starting: http://www.writethedocs.org/organizer-guide/meetups/starting/ + +Code of Conduct transparency report +----------------------------------- + +As with any Write the Docs event, this conference was covered by our `community Code of Conduct `__. +We aim to be as transparent with CoC incidents and enforcement as we can. + +To ensure that our CoC was visible and accessible, we took a number of specific steps: + +- Every participant agreed to the Code of Conduct in advance during registration. +- The CoC, or a summary, was included on the conference website and Venueless Welcome page +- The CoC was repeatedly mentioned in our conference introduction and announcements. +- We specifically stressed that the CoC applies to all conference spaces. +- We encouraged all attendees to report any incident, even if they were not sure whether it was a violation. + +None of our organizers were approached about any CoC concerns related to this event. +We know that this is, in part, a reflection of the thoughtful and inclusive community that we're so lucky to have. + +That being said, we're also very conscious of the fact that just because nothing was reported doesn't mean nothing happened. +If there was any personal conduct or other aspect of the conference experience that did not meet the expectations of behavior set out in the CoC, please email us at `conduct@writethedocs.org `_. + +Thanks again +------------ + +Thanks so much to the following companies for supporting the Portland conference this year: + +.. datatemplate:: + :source: /_data/{{shortcode}}-{{year}}-config.yaml + :template: {{year}}/sponsors-simplelist.rst + +We're so grateful to our sponsors, speakers, volunteers, and attendees for making this conference possible. Whether you were able to come out this time or not, we hope to see you again next year – or +even sooner at one of our other events! From d71e0cf5d6ee47731c98adfd6061aed593941404 Mon Sep 17 00:00:00 2001 From: Sasha Romijn Date: Mon, 7 Oct 2024 12:39:58 +0200 Subject: [PATCH 5/7] Kick build --- docs/conf/atlantic/2024/news/thank-you-recap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf/atlantic/2024/news/thank-you-recap.rst b/docs/conf/atlantic/2024/news/thank-you-recap.rst index befc62082..a51bf7c19 100644 --- a/docs/conf/atlantic/2024/news/thank-you-recap.rst +++ b/docs/conf/atlantic/2024/news/thank-you-recap.rst @@ -1,7 +1,7 @@ :template: {{year}}/generic.html :banner: _static/conf/images/headers/venue.png -.. post:: Oct 3, 2024 +.. post:: Oct 7, 2024 :tags: recap, thanks, {{year}}, {{shortcode}}-{{year}} Conference highlights From 4ff23f597406e42088ac510e52281b9693ee599a Mon Sep 17 00:00:00 2001 From: Sam Date: Mon, 7 Oct 2024 13:33:03 +0200 Subject: [PATCH 6/7] RTD updates (#2240) Re https://about.readthedocs.com/blog/2024/07/addons-by-default/ Co-authored-by: Sasha Romijn --- docs/conf.py | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/conf.py b/docs/conf.py index c7882b33b..3dfbbddbf 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -45,6 +45,20 @@ def _load_data(self, env, data_source, encoding): sys.path.append(os.getcwd()) # noqa + +# Updates for RTD changes +# https://about.readthedocs.com/blog/2024/07/addons-by-default/ + +# Define the canonical URL if you are using a custom domain on Read the Docs +html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "https://www.writethedocs.org") + +# Tell Jinja2 templates the build is running on Read the Docs +if os.environ.get("READTHEDOCS", "") == "True": + if "html_context" not in globals(): + html_context = {} + html_context["READTHEDOCS"] = True + + from _ext.core import ( render_rst_with_jinja, override_template_load_context, set_html_context, unset_html_context ) From c96d5e85e068f411b534bd7d87169bcd4e898cd1 Mon Sep 17 00:00:00 2001 From: Sam Date: Wed, 16 Oct 2024 12:26:08 +0200 Subject: [PATCH 7/7] Install docutils for rst2html for vale (#2243) * Install docutils for rst2html for vale * Install docutils for rst2html for vale * Revert "Install docutils for rst2html for vale" This reverts commit d5d6c3598ac7c733d6c20edaf7e628c4a55df0ea. --- .github/workflows/vale.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/workflows/vale.yml b/.github/workflows/vale.yml index 3de0ec48b..075a41395 100644 --- a/.github/workflows/vale.yml +++ b/.github/workflows/vale.yml @@ -19,6 +19,9 @@ jobs: steps: - uses: actions/checkout@v4 + - name: Install docutilsfor rst2html + run: sudo apt-get install -y docutils + - name: Linter uses: errata-ai/vale-action@reviewdog env: