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

Capabilities 2025

Open nrllh opened this issue 7 months ago β€’ 17 comments

Capabilities 2025

Capabilities illustration

If you're interested in contributing to the Capabilities chapter of the 2025 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 can find more details about this year’s Call for Contributions here.

πŸ’¬ Please make sure to join #web-almanac-capabilities on Slack for team coordination.

Content team

Lead Authors Reviewers Analysts Editors Coordinator
@Dawntraoz @Dawntraoz @MichaelSolati @webmaxru @guaca - @mikaelaraujo
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] πŸ“† May 18 Complete program and content committee - πŸ”‘ Organizing committee
    • The content team has at least one author, reviewer, and analyst.

1. Plan content

  • [ ] πŸ“† June 1 First meeting to outline the chapter contents - πŸ”‘ Content team
    • The content team has completed the chapter outline.

2. Gather data

  • [ ] πŸ“† July 1 Custom metrics completed - πŸ”‘ Analysts
  • [ ] πŸ“† July 1 HTTP Archive Crawl - πŸ”‘ HA Team
    • HTTP Archive runs the June crawl.

3. Validate results

  • [ ] πŸ“† September 1 Query Metrics & Save Results - πŸ”‘ Analysts
    • Analysts have queried all metrics and saved the output.

4. Draft content

  • [ ] πŸ“† October 1 First Draft of Chapter - πŸ”‘ Authors
    • Authors has written the chapter.
  • [ ] πŸ“† October 20 Review & Edit Chapter - πŸ”‘ Reviewers & Editors
    • Reviewers and Editors has processed the the chapter.

5. Publication

  • [ ] πŸ“† November 15 Chapter Publication (Markdown & PR) - πŸ”‘ Authors
    • Authors has converted the chapter to markdown and drafted a PR.
  • [ ] πŸ“† December 1 Launch of 2025 Web Almanac πŸš€ - πŸ”‘ Organizing committee

6. Live Stream

  • [ ] πŸ“† December 15 Live Stream - πŸ”‘ Content Team

Chapter resources

Refer to these 2025 capabilities resources throughout the content creation process:

nrllh avatar Apr 27 '25 19:04 nrllh

Hello! Happy to support this initiative again! Please, add me as a reviewer for this chapter.

webmaxru avatar Apr 28 '25 06:04 webmaxru

This chapter has caught my attention, will it include the built-in AI APIs this year? If so, I would love to participate as a reviewer, or even co-author if needed 😍

Dawntraoz avatar May 11 '25 20:05 Dawntraoz

This chapter has caught my attention, will it include the built-in AI APIs this year? If so, I would love to participate as a reviewer, or even co-author if needed 😍

Hey Alba, you can analyze whatever you want :) I added you as an author ;)

nrllh avatar May 13 '25 20:05 nrllh

If someone else would take lead I can contribute as a writer. I don't have the bandwidth to organize and handle metrics (last year this was my undoing and why I dropped the ball so hard). So I'd like to join in helping write this chapter.

MichaelSolati avatar May 19 '25 19:05 MichaelSolati

Hi @MichaelSolati, I added you as an author. Welcome again!

mikaelaraujo avatar May 20 '25 12:05 mikaelaraujo

@Dawntraoz @MichaelSolati @webmaxru Can we count on any of you to act as the chapter leader?

mikaelaraujo avatar May 25 '25 18:05 mikaelaraujo

@Dawntraoz @MichaelSolati, is one of you available to be the chapter leader? So, we can go ahead. We are checking for an analyst + editor. (Cc @nrllh)

mikaelaraujo avatar May 27 '25 03:05 mikaelaraujo

@mikaelaraujo I would be happy to take the lead with some help from @MichaelSolati, since it is my first time πŸ™

You can count on me, about Analysts maybe we can contact @guaca that has experience and I would love to work closely with her on this chapter 🀩

Dawntraoz avatar May 27 '25 11:05 Dawntraoz

FYI the analysis requirements for this chapter has been pretty light in previous years. Basically one custom metric that tests for all the Fugu APIs. See here: https://github.com/HTTPArchive/almanac.httparchive.org/tree/main/sql/2022/capabilities

And I poked @tomayac about adding the AI APIs to that custom metric (or a new custom metric?) already and he said he should be able to set that up in advance.

Of course if you decide to query more, then the sky's the limit on how much time to spend on this!

tunetheweb avatar May 27 '25 11:05 tunetheweb

Thank you, Alba! :)

So, I suggest that we can go ahead initially with the same setup from previous editions, as Barry said. We recommend that you (@Dawntraoz) @MichaelSolati and @webmaxru (maybe @guaca) to schedule a meeting to design the outline of this chapter. With that, we can pass any additional query for the analysts.

Aside of that:

  1. Check the [chapter resources](Chapter resources);
  2. Ensure that all of you are in the chapter's Slack channel

mikaelaraujo avatar May 27 '25 13:05 mikaelaraujo

Hello! If you need any help with the queries, I am happy to assist as an analyst πŸ˜ƒ

guaca avatar May 29 '25 22:05 guaca

Hello! If you need any help with the queries, I am happy to assist as an analyst πŸ˜ƒ

thank you!

nrllh avatar May 30 '25 03:05 nrllh

@Dawntraoz, could you please try to schedule a meeting with the content team to draft this year's outline?

nrllh avatar May 30 '25 03:05 nrllh

On my way to send an invitation to the content team πŸ™

Dawntraoz avatar Jun 01 '25 18:06 Dawntraoz

Hi folks πŸ‘‹ (Sharing the same message in the Slack channel chapter)

Recap of the call (cc @webmaxru):

  • We discussed the plan for the chapter and write down the outline based on previous editions: Google doc
  • We also discussed what queries can be useful, and @guaca helped us understand what is needed.
    • We will need to run the fugu query from previous years (maybe adding all pages Home and other internal pages) for 2024 and 2025, plus querying all news built-in AI APIs such as Translator, LanguageDetector, etc. @tunetheweb @tomayac can you help us with that?
  • Next steps:
    1. Queries get ready
    2. Estela gets access to the platform to perform them
    3. Estela execute the queries and share the results
    4. We start discussing the 7 features selected and top new 3 to be explored in the chapter in detail

Dawntraoz avatar Jun 04 '25 15:06 Dawntraoz

I've added Built-in AI API detection logic in https://github.com/HTTPArchive/custom-metrics/pull/164. Once this is merged, you should be able to query the data from within the Fugu data tables.

tomayac avatar Jun 04 '25 16:06 tomayac

You are the best @tomayac, thank you so much! πŸ€—

Dawntraoz avatar Jun 07 '25 11:06 Dawntraoz