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

Structured Data 2022

Open rviscomi opened this issue 3 years ago • 87 comments

Structured Data 2022

Structured Data illustration

If you're interested in contributing to the Structured Data chapter of the 2022 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.

Content team

Lead Authors Reviewers Analysts Editors Coordinator
@DataBytzAI @cyberandy @DataBytzAI @JohnBarrettWDW @SeoRobt @jasonbellwebdataworks @jonoalderson @rviscomi @JasmineDW @siakaramalegos
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 1: The content team has at least one author, reviewer, and analyst

1. Plan content

  • [x] May 15 The content team has completed the chapter outline in the draft doc

2. Gather data

  • [x] June 1: Analysts have added all necessary custom metrics and drafted a PR (example) to track query progress
  • June 1 - 15: HTTP Archive runs the June crawl

3. Validate results

  • [x] August 1: Analysts have queried all metrics and saved the output to the results sheet

4. Draft content

  • [ ] September 1: The content team has written, reviewed, and edited the chapter in the doc

5. Publication

  • [ ] September 15: The completed chapter and all required metadata and figures are converted to markdown and submitted to GitHub
  • September 26: Target launch date 🚀

Chapter resources

Refer to these 2022 Structured Data 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 💬 #web-almanac-structured-data on Slack for team coordination

rviscomi avatar Apr 12 '22 17:04 rviscomi

Hi @rviscomi happy to contribute as author 🤓

cyberandy avatar Apr 12 '22 19:04 cyberandy

Hi @rviscomi happy to help as author .... lot of work to be done in this space!

allen-oneill avatar Apr 12 '22 20:04 allen-oneill

Would love to lead this one again!

jonoalderson avatar Apr 14 '22 13:04 jonoalderson

@jonoalderson please do 🙏

cyberandy avatar Apr 14 '22 15:04 cyberandy

Hello @rviscomi I'd like to be an editor!

JasmineDW avatar Apr 19 '22 14:04 JasmineDW

Hey everyone, would be thrilled to participate as a reviewer!

SeoRobt avatar Apr 21 '22 01:04 SeoRobt

@jonoalderson @cyberandy would be great to have a call for intros and planning ... esp since you folk have been there before :D

allen-oneill avatar Apr 23 '22 18:04 allen-oneill

Hey @DataBytzAI yep, sounds like a plan! Carved out some time later this week to start getting things in motion 👍

jonoalderson avatar Apr 25 '22 07:04 jonoalderson

Hello! I spend my days hands-on with semantic web technologies; particularly defining, describing, and linking structured data in a distributed KG system. These are also topics I speak about at tech conferences. If there is any room to participate as an author, I would be honored to be considered.

If not, perhaps I can add value in another role. Either way, I thank you for the consideration :)

carducci avatar Apr 27 '22 02:04 carducci

@jonoalderson when suits Today/Thur/Fri for an intro call? .... I am London/Dublin time zone ... anyone else available to call? @cyberandy @carducci ?

sorry @JasmineDW @siakaramalegos @SeoRobt meant to mention you as well to join call if possible!!

allen-oneill avatar Apr 27 '22 13:04 allen-oneill

@DataBytzAI I'm available almost anytime tomorrow after 4:00PM London/Dublin time.

Friday I can connect anytime after 2:00PM London/Dublin time.

carducci avatar Apr 27 '22 14:04 carducci

Thanks @DataBytzAI great to e-meet you! I'm available anytime tomorrow or Friday, currently in Central Standard Time zone.

SeoRobt avatar Apr 27 '22 15:04 SeoRobt

Hey folks, any time Friday afternoon works for me. Shall we aim for 4pm UTC on Friday?

jonoalderson avatar Apr 28 '22 08:04 jonoalderson

Structured data call Friday 16:00 UTC (17:00 London time), good for everyone else? @cyberandy @carducci @JasmineDW @siakaramalegos @SeoRobt

cc: @jonoalderson

allen-oneill avatar Apr 28 '22 11:04 allen-oneill

Assuming the time works for everyone, I have created a zoom room.

Michael C (He/Him) is inviting you to a scheduled Zoom meeting.

Topic: Structured Data 2022 Time: Apr 29, 2022 04:00 PM Universal Time UTC

Join Zoom Meeting https://us06web.zoom.us/j/81102069402?pwd=UDBqclNMWWtZK0tVdzBtTUY1ajBDUT09

Meeting ID: 811 0206 9402 Passcode: 312040 One tap mobile +12532158782,,81102069402#,,,,*312040# US (Tacoma) +13462487799,,81102069402#,,,,*312040# US (Houston)

Dial by your location +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) +1 301 715 8592 US (Washington DC) +1 312 626 6799 US (Chicago) +1 929 436 2866 US (New York) Meeting ID: 811 0206 9402 Passcode: 312040 Find your local number: https://us06web.zoom.us/u/kcti4pHfFj

@cyberandy @DataBytzAI @JasmineDW @SeoRobt @siakaramalegos

cc: @jonoalderson

carducci avatar Apr 28 '22 15:04 carducci

Hey @carducci thanks for setting that up. Confirming that the meeting will be at 6 UTC? The invite shows 4 UTC. Talk tomorrow!

SeoRobt avatar Apr 28 '22 15:04 SeoRobt

Structured data call Friday 16:00 UTC (17:00 London time), good for everyone else?

Are we moving to 18:00 UTC? Happy to update the meeting but I want to confirm

carducci avatar Apr 28 '22 15:04 carducci

Structured data call Friday 16:00 UTC (17:00 London time), good for everyone else?

Are we moving to 18:00 UTC? Happy to update the meeting but I want to confirm

fine here (7pm London time)

allen-oneill avatar Apr 28 '22 16:04 allen-oneill

I'm flexible.

jonoalderson avatar Apr 28 '22 16:04 jonoalderson

Sincere apologies @carducci, the Zoom invite for 16:00 UTC is correct and works for everyone.

SeoRobt avatar Apr 28 '22 21:04 SeoRobt

I'll be there, though annoyingly I have a hard stop for another call at 16:30 UTC. :(

jonoalderson avatar Apr 29 '22 15:04 jonoalderson

Hey folks, on your call, can you also discuss roles? Jono volunteered to be a lead though the Almanac does like to switch these up each year if possible. So let us know if anyone else wants to volunteer for that and then Rick can make a final decision.

You also have a lot of co-author volunteers but not as many reviewers. Reviewers also give feedback/guidance at the outline stage so your role is not only at the very end but influences content. So if you think you might have less overall time to give, then being a reviewer instead could be an option.

Don't forget to join the Slack (link in issue above)!

siakaramalegos avatar Apr 29 '22 15:04 siakaramalegos

Oh you still need an analyst too so if you could help recruit for that, it would be great. If someone knows at least some SQL we can get them trained up for the rest. And the queries are done in the almanac account so they won't be charged for it. It's a really cool data set to explore for anyone interested.

siakaramalegos avatar Apr 29 '22 15:04 siakaramalegos

So let us know if anyone else wants to volunteer for that

Hi @siakaramalegos ... happy to volunteer for lead if Rick wants to rotate that role!

allen-oneill avatar Apr 29 '22 15:04 allen-oneill

Nice one, that'd be great! I'm very happy to step into some author shoes.

jonoalderson avatar Apr 29 '22 15:04 jonoalderson

REMINDER: CALL IN 5 MINUTES:

Michael C (He/Him) is inviting you to a scheduled Zoom meeting.

Topic: Structured Data 2022 Time: Apr 29, 2022 04:00 PM Universal Time UTC

Join Zoom Meeting https://us06web.zoom.us/j/81102069402?pwd=UDBqclNMWWtZK0tVdzBtTUY1ajBDUT09

Meeting ID: 811 0206 9402 Passcode: 312040 One tap mobile +12532158782,,81102069402#,,,,*312040# US (Tacoma) +13462487799,,81102069402#,,,,*312040# US (Houston)

Dial by your location +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) +1 669 900 6833 US (San Jose) +1 301 715 8592 US (Washington DC) +1 312 626 6799 US (Chicago) +1 929 436 2866 US (New York) Meeting ID: 811 0206 9402 Passcode: 312040 Find your local number: https://us06web.zoom.us/u/kcti4pHfFj

allen-oneill avatar Apr 29 '22 15:04 allen-oneill

Tentatively adding myself as the analyst to help meet Milestone 0.

rviscomi avatar May 02 '22 18:05 rviscomi

Just following up. When can get all get together for that mind-mapping session? Does the same time as last Friday work for folks on the 6th?

carducci avatar May 04 '22 17:05 carducci

I'm travelling but if other folk are available it would be great to get that started, thanks Michael!

allen-oneill avatar May 04 '22 22:05 allen-oneill

I'm also travelling this Friday, free next week

SeoRobt avatar May 05 '22 11:05 SeoRobt