almanac.httparchive.org icon indicating copy to clipboard operation
almanac.httparchive.org copied to clipboard

CMS 2024

Open nrllh opened this issue 1 year ago • 13 comments

CMS 2024

CMS illustration

If you're interested in contributing to the CMS chapter of the 2024 Web Almanac, please reply to this issue and indicate which role or roles best fit your interest and availability: author, reviewer, analyst, and/or editor. You might be interested in exploring the changes to this year's version here.

Content team

Lead Authors Reviewers Analysts Editors Coordinator
@sirjonathan @sirjonathan, @LoraRaykova, @niko-kaleev @raewrites, @karmatosed @sirjonathan, @nrllh - @turban1988
Expand for more information about each role 👀
  • The content team lead is the chapter owner and responsible for setting the scope of the chapter and managing contributors' day-to-day progress.
  • Authors are subject matter experts and lead the content direction for each chapter. Chapters typically have one or two authors. Authors are responsible for planning the outline of the chapter, analyzing stats and trends, and writing the annual report.
  • Reviewers are also subject matter experts and assist authors with technical reviews during the planning, analyzing, and writing phases.
  • Analysts are responsible for researching the stats and trends used throughout the Almanac. Analysts work closely with authors and reviewers during the planning phase to give direction on the types of stats that are possible from the dataset, and during the analyzing/writing phases to ensure that the stats are used correctly.
  • Editors are technical writers who have a penchant for both technical and non-technical content correctness. Editors have a mastery of the English language and work closely with authors to help wordsmith content and ensure that everything fits together as a cohesive unit.
  • The section coordinator is the overall owner for all chapters within a section like "User Experience" or "Page Content" and helps to keep each chapter on schedule.

Note: The time commitment for each role varies by the chapter's scope and complexity as well as the number of contributors.

For an overview of how the roles work together at each phase of the project, see the Chapter Lifecycle doc.

Milestone checklist

0. Form the content team

  • [x] 📆 April 15 Complete program and content committee - 🔑 Organizing committee
    • The content team has at least one author, reviewer, and analyst.

1. Plan content

  • [x] 📆 May 1 First meeting to outline the chapter contents - 🔑 Content team
    • The content team has completed the chapter outline.

2. Gather data

  • [x] 📆 June 1 Custom metrics completed - 🔑 Analysts
  • [x] 📆 June 1 HTTP Archive Crawl - 🔑 HA Team
    • HTTP Archive runs the June crawl.

3. Validate results

  • [x] 📆 August 15 Query Metrics & Save Results - 🔑 Analysts
    • Analysts have queried all metrics and saved the output.

4. Draft content

  • [x] 📆 September 15 First Draft of Chapter - 🔑 Authors
    • Authors has written the chapter.
  • [ ] 📆 October 10 Review & Edit Chapter - 🔑 Reviewers & Editors
    • Reviewers and Editors has processed the the chapter.

5. Publication

  • [ ] 📆 October 15 Chapter Publication (Markdown & PR) - 🔑 Authors
    • Authors has converted the chapter to markdown and drafted a PR.
  • [ ] 📆 November 1 Launch of 2024 Web Almanac 🚀 - 🔑 Organizing committee

6. Virtual conference

  • [ ] 📆 November 20 Virtual Conference - 🔑 Content Team

Chapter resources

Refer to these 2024 CMS resources throughout the content creation process: 📄 Google Docs for outlining and drafting content 🔍 SQL files for committing the queries used during analysis 📊 Google Sheets for saving the results of queries 📝 Markdown file for publishing content and managing public metadata 💻 Collab notebook for collaborative coding in Python - if needed 💬 #web-almanac-cms on Slack for team coordination

nrllh avatar Mar 02 '24 18:03 nrllh

I'm happy that the project is back again! I'd love to return and contribute as either author or co-author of this year's chapter.

sirjonathan avatar Mar 05 '24 05:03 sirjonathan

Hey @alexdenning @dknauss @alonkochba @honzasladek @csliva @dknauss - awesome contributors from previous years 🙂 Are you interested in joining us again this year?

nrllh avatar Apr 09 '24 22:04 nrllh

I'm interested in reviewing. I'm an experienced writer and editor and have previously worked with @sirjonathan. I'll be away most of September but will be back on the 27th, so it would be good to co-review with someone else.

raewrites avatar Apr 18 '24 11:04 raewrites

I am also interested in reviewing. I have experience within the area and can be a subject matter reviewer along with having worked with @sirjonathan to aid collaboration.

karmatosed avatar Apr 19 '24 10:04 karmatosed

Hi @sirjonathan, Thank you very much for volunteering to lead the writing of this chapter! Could you please organize a kick-off meeting for this chapter (example: https://github.com/HTTPArchive/almanac.httparchive.org/issues/3603#issuecomment-2064351177) to organize the writing of the chapter?

Furthermore, it would be helpful if you and all other contributors (@LoraRaykova, @niko-kaleev, @raewrites @karmatosed ) could join the slack channel of the HTTPArchive (https://join.slack.com/t/httparchive/shared_invite/zt-2hfkn28ts-~uXN4UGS0mXsKpzzhtZcow)

Thanks!

turban1988 avatar Apr 22 '24 10:04 turban1988

@turban1988 I've reached out to the team and am planning to hold the kickoff meeting next week.

sirjonathan avatar Apr 30 '24 17:04 sirjonathan

@LoraRaykova, @niko-kaleev, and I met today. We discussed the previous years efforts and ideas for improving / expanding this year's chapter, including references to the Speculation Rules API and tracking themes within the WordPress section.

Our plan is to start by pulling over the 2022 outline and expand it with our ideas for this year. @niko-kaleev will take the first pass at that and we'll work on it together async.

We're meeting again on the 28th to finalize the outline after which I'll follow-up on any analyst related tasks.

/cc @turban1988

sirjonathan avatar May 16 '24 16:05 sirjonathan

As discussed with @sirjonathan and @LoraRaykova on the kick-off meeting, the chapter outline is ready:

https://docs.google.com/document/d/13CxAp7HCcxHHCSuEnXS2rolKskLSlUvLQuqUD6QADYc/edit

@sirjonathan will review it next week, and we'll finalize it on the 28th.

/cc @turban1988

niko-kaleev avatar May 17 '24 08:05 niko-kaleev

@Niko Kaleev @Lora Raykova and I met on Tuesday for a sync. The outline is in good shape and they're going to start on the parts of the chapter they can while we wait for data.

@nrllh has generously agreed to tackle the analyst work and replicate the analysis from the 2022 edition.

sirjonathan avatar May 31 '24 22:05 sirjonathan

@niko-kaleev and I met today for a quick check-in. We discussed next steps and scheduled a follow-up for August 20, once we have results validated.

sirjonathan avatar Jul 16 '24 14:07 sirjonathan

@sirjonathan Do you still need a hand? I have time to help if you're still working through the reviewing and editing.

dknauss avatar Aug 26 '24 23:08 dknauss

You can find the first draft at the bottom of the document: https://docs.google.com/document/d/13CxAp7HCcxHHCSuEnXS2rolKskLSlUvLQuqUD6QADYc/edit

What still needs to be done:

  1. @sirjonathan to write the Page Builders section (under WordPress 2024), as discussed during our kick-off meeting
  2. @sirjonathan to draw and write the conclusion

Keep in mind that a lot of the data presented in 2022 was missing from this year's data export. All the missing data points are highlighted in red or in a comment.

@sirjonathan, would you mind extracting the missing data points and writing a paragraph or two for each? We believe that will make the whole chapter even more valuable to our readers.

niko-kaleev avatar Sep 13 '24 06:09 niko-kaleev

@niko-kaleev Thank you for the update! I'm planning to set aside some time during WordCamp US next week to work on 1 and 2. Regarding the missing data points, I'll take another look and see what's possible - I just may need technical help.

sirjonathan avatar Sep 13 '24 23:09 sirjonathan