From 973775336b936f8cd0c46af1cfdf7b26280acb4b Mon Sep 17 00:00:00 2001 From: Eric Holscher Date: Mon, 9 Jan 2023 15:53:41 -0800 Subject: [PATCH 1/6] Add 2023 Community Kickoff & Stats posts A couple big changes around our teams and conferences. Hopefully I conveyed them well, but edits always welcome! Also happy to note any other major things that I might have spaced on, just let me know. --- docs/blog/2023-community-kickoff.rst | 122 ++++++++++++++++++++++++ docs/blog/write-the-docs-2022-stats.rst | 88 +++++++++++++++++ 2 files changed, 210 insertions(+) create mode 100644 docs/blog/2023-community-kickoff.rst create mode 100644 docs/blog/write-the-docs-2022-stats.rst diff --git a/docs/blog/2023-community-kickoff.rst b/docs/blog/2023-community-kickoff.rst new file mode 100644 index 0000000000..d681d2e3aa --- /dev/null +++ b/docs/blog/2023-community-kickoff.rst @@ -0,0 +1,122 @@ +.. post:: Jan 17, 2023 + :tags: stats, year in review, newsletter + :author: Eric Holscher + +Write the Docs Community Kickoff - January 2023 +=============================================== + +Hey folks, Eric Holscher here, one of the co-founders of Write the Docs. +I'm here with the traditional January community update, +which goes out in place of the newsletter. + +We're excited about a lot of things this year, +but most of all we're excited to see you all again in-person. + +Our 2023 conferences +-------------------- + +Thanks to everyone who attended our virtual events in 2022. +We had wonderful attendance in Portland, Prague, and Australia. +We continue to appreciate the warmth and spirit that you bring to our virtual events, +and look forward to more of it in 2023. + +We are excited this year for a partial return to in-person events, +and a new experiment for our virtual event: + +* `Portland `_ will be in-person on **May 7-9**. +* `Atlantic `_ will be a virtual event, spanning the US and European timezones, on **September 10-12**. + +We hope that you'll work with us to make all of our events unique again this year by submitting talks, +and showing up with your usual enthusiasm and warmth. + +Team restructuring +------------------ + +There are some changes coming to our teams this year, +specifically the `CoreOps team `_ and new `Community board `_. + +The *CoreOps team* is a small group of us that have been working to make Write the Docs happen for a long time. +Historically this group has included our Portland & Prague conference chairs, +along with a couple other folks heavily involved in the overall operation of Write the Docs. +It's responsible for the tasks involved in keeping Write the Docs a viable organization. + +The major change happening there is that Mikey Ariel will moving into a new role focused on non-conference community development. +Sasha Romijn will be filling the role of conference chair for our Atlantic conference. +The other members of the CoreOps team, myself & Samuel Wright, will continue with our current roles. + +The *Community board* is new, and tasked with the overall direction of the community. +The members are the team leads of each of the Write the Docs team, +as well as the conference chairs of our various conferences. +Our goal is to have meetings quarterly where we all share the status of what we're working on, +and any help that we could use in keeping the various teams functioning effectively. +We're hoping that having more defined communication will help people feel more connected and supported in the work we're all doing. + +You can see the full set of changes in `pull request 1811 `_. + +Other community updates +----------------------- + +We have shared our high-level community stats for the past 5 years, +and will continue to do it each year going forward. +You can view our 2022 stats on our blog at :doc:`/blog/write-the-docs-2022-stats`. + +We're are now accepting `talk proposals `_ and selling tickets for our Portland conference. +It would be great to see you all in-person this year. + +**Submit your talk proposals by February 6th**, +If you need feedback or help with your talk proposal, +we will be having a `virtual talk prep meetup `_. +The meetup will be announced soon, so follow that group or the ``#meetups`` channel in Slack for updates. + +From our sponsor +---------------- + +This month’s newsletter is sponsored by Zoomin: + +.. raw:: html + +
+ + + + + + + +
+

+ Fast and easy content delivery! Publish content everywhere at the click of a button to maximize your team productivity +

+ +

+ Watch our latest panel on what your documentation team can start doing today to prepare for M&A +

+ 		+ + Zoomin + +
+
+ +*Interested in sponsoring the newsletter? Take a look at our* `sponsorship prospectus `__. + + +Featured job posts +------------------ + +* `Technical Content Marketer `__, Chainlink Labs + Remote, full-time +* `Technical Writer `__, Tecton + Remote (San Francisco, CA, USA), full-time +* `Technical Writer `__, Corrily + Remote, part-time + +*To apply for these jobs and more, visit the* `Write the Docs job board `_. + + +Have a great year +----------------- + +Thanks again for being part of our journey. + +The Write the Docs team diff --git a/docs/blog/write-the-docs-2022-stats.rst b/docs/blog/write-the-docs-2022-stats.rst new file mode 100644 index 0000000000..e378dfc5a5 --- /dev/null +++ b/docs/blog/write-the-docs-2022-stats.rst @@ -0,0 +1,88 @@ +.. post:: Jan 13, 2023 + :tags: stats, year in review + :author: Eric Holscher + +Write the Docs 2022 Stats +========================= + +This year we have done a :doc:`/blog/2023-january-community-update` post along with our stats. +Check there for context around the community going into 2023. + +Unfortunately our Podcast has been in hiatus for a while with no new episodes in 2022, +so we have removed it from the stats post. + +2022 Stats +---------- + +We have shared our high-level community stats for the past 5 years, +and will continue to do it each year going forward. + +You can read our previous posts from 2016_, 2017_, 2018_, 2019_, 2020_, 2022_. + +.. _2022: https://www.writethedocs.org/blog/write-the-docs-2022-stats/ +.. _2020: https://www.writethedocs.org/blog/write-the-docs-2020-stats/ +.. _2019: https://www.writethedocs.org/blog/write-the-docs-2019-stats/ +.. _2018: https://www.writethedocs.org/blog/write-the-docs-2018-stats/ +.. _2017: https://www.writethedocs.org/blog/write-the-docs-2017-stats/ +.. _2016: https://www.writethedocs.org/blog/write-the-docs-2016-year-in-review/ + +Conferences +~~~~~~~~~~~ + +* 650 attendees in Portland (down from 650) +* 225 attendees in Prague (up from 330) +* 100 attendees in Australia (no conference in 2022) + +We were excited to see continued success of the virtual conferences, +but it definitely felt like more people are slowly yearning to return to in-person. +The world has also had another large shock with the war in Ukraine, +which we expect to have lowered our 2022 attendance in Prague. + +Slack Network +~~~~~~~~~~~~~ + +* 18,339 :doc:`members ` (up from 15,012) + +Newsletters +~~~~~~~~~~~ + +* 10,558 :doc:`subscribers ` (up from 9,237) + +This is across all our various mailing lists (conference-specific and community newsletter). + +Meetups +~~~~~~~ + +* Over 10,000 :doc:`members (too many to count) + +Last year we stopped counting total meetups because we launched Quorum meetups that cover a larger geographic area. +We're excited to see a return to in-person meetups, +with the easing of COVID concerns in various areas where we have meetups. + +Website +~~~~~~~ + +* 270,000 sessions (up from 250,000) +* 440,000 page views (up from 395,000) + +Our website traffic is generally pretty stable, +but we do see spikes around our conferences. +This number comes from Google Analytics which many users are blocking, +so the numbers are likely much higher in terms of total traffic. + +GitHub +~~~~~~ + +* 745 commits_ to our repository (down from 1,193) +* 26 people_ who contributed to our repository (down from 30) + +.. commits: git rev-list --count --all --after="2022-01-01" --before="2023-01-01" +.. _commits: https://github.com/writethedocs/www/commits/master +.. _people: https://github.com/writethedocs/www/graphs/contributors?from=2022-01-01&to=2023-01-01&type=c + +Thanks +------ + +Thanks again for being part of our journey, + +The Write the Docs team From e401af3299af1a4cd957d19b3d2ef1d9e37227c1 Mon Sep 17 00:00:00 2001 From: Eric Holscher <25510+ericholscher@users.noreply.github.com> Date: Tue, 10 Jan 2023 14:14:34 -0900 Subject: [PATCH 2/6] Apply suggestions from code review Co-authored-by: Mikey Ariel Co-authored-by: Sam --- docs/blog/2023-community-kickoff.rst | 25 +++++++++++-------------- docs/blog/write-the-docs-2022-stats.rst | 7 +++---- 2 files changed, 14 insertions(+), 18 deletions(-) diff --git a/docs/blog/2023-community-kickoff.rst b/docs/blog/2023-community-kickoff.rst index d681d2e3aa..f191e667aa 100644 --- a/docs/blog/2023-community-kickoff.rst +++ b/docs/blog/2023-community-kickoff.rst @@ -2,12 +2,11 @@ :tags: stats, year in review, newsletter :author: Eric Holscher -Write the Docs Community Kickoff - January 2023 +Write the Docs Community Update - January 2023 =============================================== Hey folks, Eric Holscher here, one of the co-founders of Write the Docs. -I'm here with the traditional January community update, -which goes out in place of the newsletter. +I'm here with our traditional January community update. We're excited about a lot of things this year, but most of all we're excited to see you all again in-person. @@ -16,7 +15,7 @@ Our 2023 conferences -------------------- Thanks to everyone who attended our virtual events in 2022. -We had wonderful attendance in Portland, Prague, and Australia. +We had wonderful attendance in all three of our online events, nominally located in Portland, Prague, and Australia. We continue to appreciate the warmth and spirit that you bring to our virtual events, and look forward to more of it in 2023. @@ -26,21 +25,20 @@ and a new experiment for our virtual event: * `Portland `_ will be in-person on **May 7-9**. * `Atlantic `_ will be a virtual event, spanning the US and European timezones, on **September 10-12**. -We hope that you'll work with us to make all of our events unique again this year by submitting talks, -and showing up with your usual enthusiasm and warmth. +We hope that you'll work with us to make all of our events unique again this year by submitting talks and showing up in person or virtually with your usual enthusiasm and warmth. -Team restructuring ------------------- +Community teams restructuring +----------------------------- There are some changes coming to our teams this year, -specifically the `CoreOps team `_ and new `Community board `_. +specifically the `Core Operations (CoreOps) team `_ and new `Community board `_. The *CoreOps team* is a small group of us that have been working to make Write the Docs happen for a long time. Historically this group has included our Portland & Prague conference chairs, -along with a couple other folks heavily involved in the overall operation of Write the Docs. +along with a couple other folks heavily involved in the overall operation of Write the Docs, such as website infrastructure and community support. It's responsible for the tasks involved in keeping Write the Docs a viable organization. -The major change happening there is that Mikey Ariel will moving into a new role focused on non-conference community development. +The major change happening there is that Mikey Ariel will be stepping down as the Prague conference chair and moving to a new role focused on global and non-conference community development. Sasha Romijn will be filling the role of conference chair for our Atlantic conference. The other members of the CoreOps team, myself & Samuel Wright, will continue with our current roles. @@ -48,8 +46,8 @@ The *Community board* is new, and tasked with the overall direction of the commu The members are the team leads of each of the Write the Docs team, as well as the conference chairs of our various conferences. Our goal is to have meetings quarterly where we all share the status of what we're working on, -and any help that we could use in keeping the various teams functioning effectively. -We're hoping that having more defined communication will help people feel more connected and supported in the work we're all doing. +and request any help that we could use in keeping the various teams functioning effectively. +We're hoping that having more defined communication will help the community teams (mostly run by volunteers) to feel more connected and supported in the work we're all doing. You can see the full set of changes in `pull request 1811 `_. @@ -61,7 +59,6 @@ and will continue to do it each year going forward. You can view our 2022 stats on our blog at :doc:`/blog/write-the-docs-2022-stats`. We're are now accepting `talk proposals `_ and selling tickets for our Portland conference. -It would be great to see you all in-person this year. **Submit your talk proposals by February 6th**, If you need feedback or help with your talk proposal, diff --git a/docs/blog/write-the-docs-2022-stats.rst b/docs/blog/write-the-docs-2022-stats.rst index e378dfc5a5..2d26a8d9e6 100644 --- a/docs/blog/write-the-docs-2022-stats.rst +++ b/docs/blog/write-the-docs-2022-stats.rst @@ -5,8 +5,7 @@ Write the Docs 2022 Stats ========================= -This year we have done a :doc:`/blog/2023-january-community-update` post along with our stats. -Check there for context around the community going into 2023. +This year we have done a :doc:`/blog/2023-january-community-update` post along with our stats, which has more context and information about where we're headed in 2023. Unfortunately our Podcast has been in hiatus for a while with no new episodes in 2022, so we have removed it from the stats post. @@ -43,8 +42,8 @@ Slack Network * 18,339 :doc:`members ` (up from 15,012) -Newsletters -~~~~~~~~~~~ +Newsletter subscribers +~~~~~~~~~~~~~~~~~~~~~ * 10,558 :doc:`subscribers ` (up from 9,237) From 053eb9290d4ddc0bd68dfaf55d4968daeff24698 Mon Sep 17 00:00:00 2001 From: Eric Holscher Date: Tue, 10 Jan 2023 15:20:42 -0800 Subject: [PATCH 3/6] Fix feedback --- ...unity-kickoff.rst => 2023-january-update.rst} | 16 +++++++++------- docs/blog/write-the-docs-2022-stats.rst | 12 ++++++------ 2 files changed, 15 insertions(+), 13 deletions(-) rename docs/blog/{2023-community-kickoff.rst => 2023-january-update.rst} (90%) diff --git a/docs/blog/2023-community-kickoff.rst b/docs/blog/2023-january-update.rst similarity index 90% rename from docs/blog/2023-community-kickoff.rst rename to docs/blog/2023-january-update.rst index f191e667aa..bef1fe1694 100644 --- a/docs/blog/2023-community-kickoff.rst +++ b/docs/blog/2023-january-update.rst @@ -25,6 +25,12 @@ and a new experiment for our virtual event: * `Portland `_ will be in-person on **May 7-9**. * `Atlantic `_ will be a virtual event, spanning the US and European timezones, on **September 10-12**. +We are now accepting `talk proposals `_ and selling tickets for our Portland conference. +**Submit your talk proposals by February 6th**, +If you need feedback or help with your talk proposal, +we will be having a virtual talk prep meetup later this month. +The meetup will be announced soon, so follow that group or the ``#meetups`` channel in Slack for updates. + We hope that you'll work with us to make all of our events unique again this year by submitting talks and showing up in person or virtually with your usual enthusiasm and warmth. Community teams restructuring @@ -49,7 +55,7 @@ Our goal is to have meetings quarterly where we all share the status of what we' and request any help that we could use in keeping the various teams functioning effectively. We're hoping that having more defined communication will help the community teams (mostly run by volunteers) to feel more connected and supported in the work we're all doing. -You can see the full set of changes in `pull request 1811 `_. +You can see the full set of changes in `WEP 4 `_. Other community updates ----------------------- @@ -58,12 +64,8 @@ We have shared our high-level community stats for the past 5 years, and will continue to do it each year going forward. You can view our 2022 stats on our blog at :doc:`/blog/write-the-docs-2022-stats`. -We're are now accepting `talk proposals `_ and selling tickets for our Portland conference. - -**Submit your talk proposals by February 6th**, -If you need feedback or help with your talk proposal, -we will be having a `virtual talk prep meetup `_. -The meetup will be announced soon, so follow that group or the ``#meetups`` channel in Slack for updates. +Submissions for our fourth annual salary survey have closed and we're eagerly poring over the numbers. +Expect the full report, analyzing salary information from 524 documentarians in 42 countries, in the first quarter of this year. From our sponsor ---------------- diff --git a/docs/blog/write-the-docs-2022-stats.rst b/docs/blog/write-the-docs-2022-stats.rst index 2d26a8d9e6..cd86c2e69c 100644 --- a/docs/blog/write-the-docs-2022-stats.rst +++ b/docs/blog/write-the-docs-2022-stats.rst @@ -5,7 +5,7 @@ Write the Docs 2022 Stats ========================= -This year we have done a :doc:`/blog/2023-january-community-update` post along with our stats, which has more context and information about where we're headed in 2023. +This year we have done a :doc:`/blog/2023-january-update` post along with our stats, which has more context and information about where we're headed in 2023. Unfortunately our Podcast has been in hiatus for a while with no new episodes in 2022, so we have removed it from the stats post. @@ -28,8 +28,8 @@ You can read our previous posts from 2016_, 2017_, 2018_, 2019_, 2020_, 2022_. Conferences ~~~~~~~~~~~ -* 650 attendees in Portland (down from 650) -* 225 attendees in Prague (up from 330) +* 600 attendees in Portland (down from 650) +* 225 attendees in Prague (down from 330) * 100 attendees in Australia (no conference in 2022) We were excited to see continued success of the virtual conferences, @@ -37,13 +37,13 @@ but it definitely felt like more people are slowly yearning to return to in-pers The world has also had another large shock with the war in Ukraine, which we expect to have lowered our 2022 attendance in Prague. -Slack Network +Slack network ~~~~~~~~~~~~~ * 18,339 :doc:`members ` (up from 15,012) Newsletter subscribers -~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~ * 10,558 :doc:`subscribers ` (up from 9,237) @@ -52,7 +52,7 @@ This is across all our various mailing lists (conference-specific and community Meetups ~~~~~~~ -* Over 10,000 :doc:`members (too many to count) +* Over 10,000 :doc:`members ` (too many to count) Last year we stopped counting total meetups because we launched Quorum meetups that cover a larger geographic area. We're excited to see a return to in-person meetups, From eaae7bb7192ae3eca9dea5a6d978f60fde37d597 Mon Sep 17 00:00:00 2001 From: Eric Holscher <25510+ericholscher@users.noreply.github.com> Date: Thu, 12 Jan 2023 14:43:53 -0800 Subject: [PATCH 4/6] Apply suggestions from code review Co-authored-by: Sam --- docs/blog/write-the-docs-2022-stats.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/blog/write-the-docs-2022-stats.rst b/docs/blog/write-the-docs-2022-stats.rst index cd86c2e69c..f5e7e3abdd 100644 --- a/docs/blog/write-the-docs-2022-stats.rst +++ b/docs/blog/write-the-docs-2022-stats.rst @@ -13,12 +13,13 @@ so we have removed it from the stats post. 2022 Stats ---------- -We have shared our high-level community stats for the past 5 years, +We have shared our high-level community stats since 2016, and will continue to do it each year going forward. -You can read our previous posts from 2016_, 2017_, 2018_, 2019_, 2020_, 2022_. +You can read our previous posts from 2016_, 2017_, 2018_, 2019_, 2020_, _2021_, 2022_. .. _2022: https://www.writethedocs.org/blog/write-the-docs-2022-stats/ +.. _2021: https://www.writethedocs.org/blog/write-the-docs-2021-stats/ .. _2020: https://www.writethedocs.org/blog/write-the-docs-2020-stats/ .. _2019: https://www.writethedocs.org/blog/write-the-docs-2019-stats/ .. _2018: https://www.writethedocs.org/blog/write-the-docs-2018-stats/ @@ -34,7 +35,7 @@ Conferences We were excited to see continued success of the virtual conferences, but it definitely felt like more people are slowly yearning to return to in-person. -The world has also had another large shock with the war in Ukraine, +The world has also had another large shock with the Russian invasion of Ukraine, which we expect to have lowered our 2022 attendance in Prague. Slack network From 2d4f36a23829c32c35855f69d92734b17f3fc337 Mon Sep 17 00:00:00 2001 From: Eric Holscher Date: Thu, 12 Jan 2023 14:45:28 -0800 Subject: [PATCH 5/6] Remove old job posts & 2022 link --- docs/blog/2023-january-update.rst | 14 -------------- docs/blog/write-the-docs-2022-stats.rst | 6 ++---- 2 files changed, 2 insertions(+), 18 deletions(-) diff --git a/docs/blog/2023-january-update.rst b/docs/blog/2023-january-update.rst index bef1fe1694..e9fd001c7f 100644 --- a/docs/blog/2023-january-update.rst +++ b/docs/blog/2023-january-update.rst @@ -99,20 +99,6 @@ This month’s newsletter is sponsored by Zoomin: *Interested in sponsoring the newsletter? Take a look at our* `sponsorship prospectus `__. - -Featured job posts ------------------- - -* `Technical Content Marketer `__, Chainlink Labs - Remote, full-time -* `Technical Writer `__, Tecton - Remote (San Francisco, CA, USA), full-time -* `Technical Writer `__, Corrily - Remote, part-time - -*To apply for these jobs and more, visit the* `Write the Docs job board `_. - - Have a great year ----------------- diff --git a/docs/blog/write-the-docs-2022-stats.rst b/docs/blog/write-the-docs-2022-stats.rst index f5e7e3abdd..b1fdf6277c 100644 --- a/docs/blog/write-the-docs-2022-stats.rst +++ b/docs/blog/write-the-docs-2022-stats.rst @@ -16,9 +16,8 @@ so we have removed it from the stats post. We have shared our high-level community stats since 2016, and will continue to do it each year going forward. -You can read our previous posts from 2016_, 2017_, 2018_, 2019_, 2020_, _2021_, 2022_. +You can read our previous posts from 2016_, 2017_, 2018_, 2019_, 2020_, _2021_. -.. _2022: https://www.writethedocs.org/blog/write-the-docs-2022-stats/ .. _2021: https://www.writethedocs.org/blog/write-the-docs-2021-stats/ .. _2020: https://www.writethedocs.org/blog/write-the-docs-2020-stats/ .. _2019: https://www.writethedocs.org/blog/write-the-docs-2019-stats/ @@ -35,8 +34,7 @@ Conferences We were excited to see continued success of the virtual conferences, but it definitely felt like more people are slowly yearning to return to in-person. -The world has also had another large shock with the Russian invasion of Ukraine, -which we expect to have lowered our 2022 attendance in Prague. +The world has also had another large shock with the Russian invasion of Ukraine. Slack network ~~~~~~~~~~~~~ From b7faf360f24a53d0b64c1baa60f7005b71f87fe1 Mon Sep 17 00:00:00 2001 From: Eric Holscher <25510+ericholscher@users.noreply.github.com> Date: Thu, 12 Jan 2023 13:46:51 -0900 Subject: [PATCH 6/6] Update docs/blog/2023-january-update.rst --- docs/blog/2023-january-update.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/blog/2023-january-update.rst b/docs/blog/2023-january-update.rst index e9fd001c7f..f183180ad5 100644 --- a/docs/blog/2023-january-update.rst +++ b/docs/blog/2023-january-update.rst @@ -1,4 +1,4 @@ -.. post:: Jan 17, 2023 +.. post:: Jan 12, 2023 :tags: stats, year in review, newsletter :author: Eric Holscher