Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fonts 2022 #2883

Closed
6 tasks done
rviscomi opened this issue Apr 12, 2022 · 34 comments · Fixed by #3148
Closed
6 tasks done

Fonts 2022 #2883

rviscomi opened this issue Apr 12, 2022 · 34 comments · Fixed by #3148
Assignees
Labels
2022 chapter Tracking issue for a 2022 chapter ASAP This issue is blocking progress
Projects

Comments

@rviscomi
Copy link
Member

rviscomi commented Apr 12, 2022

Fonts 2022

Fonts illustration

If you're interested in contributing to the Fonts 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
@bramstein @bramstein @RoelN @svgeesus @jmsole @alexnj @konfirmed @shantsis @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

  • May 1: The content team has at least one author, reviewer, and analyst

1. Plan content

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

2. Gather data

  • 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

  • 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 Fonts 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-fonts on Slack for team coordination

@rviscomi rviscomi added 2022 chapter Tracking issue for a 2022 chapter help wanted Extra attention is needed labels Apr 12, 2022
@rviscomi rviscomi added this to the 2022 Content Planning milestone Apr 12, 2022
@konfirmed
Copy link
Contributor

I'll like to be an analyst in this chapter.

@rviscomi rviscomi added this to TODO in 2022 via automation Apr 13, 2022
@rviscomi rviscomi moved this from TODO to In Progress in 2022 Apr 13, 2022
@siakaramalegos siakaramalegos added help wanted: reviewers This chapter is looking for reviewers help wanted: coauthors This chapter is looking for coauthors labels Apr 15, 2022
@RoelN
Copy link
Contributor

RoelN commented Apr 19, 2022

I'd like to apply for reviewer, and figuring out what interesting details to pull from the huge heap of font data!

@bramstein
Copy link
Contributor

I'd be happy to review as well (if you need more than one.)

@siakaramalegos
Copy link
Member

@bramstein the more the merrier! Thanks!

@siakaramalegos
Copy link
Member

I just re-read the 2020 chapter, and noticed a lot of performance stuff in it. If someone is interested in authoring but isn't as confident in the performance side, I can be a backup co-author for that. I'd prefer not to be because I'm also a section coordinator, but I really want this chapter to happen this year so offering just in case it's needed :)

@svgeesus
Copy link
Contributor

I'm happy to be a reviewer, and can also contribute towards some of the content planning.

Given the previous couple of years, what is definitely needed is a strong overall lead and primary author; and I'm not able to put myself forward for that role given my other commitments over the same time period.

@jmsole
Copy link

jmsole commented Apr 19, 2022

I don't know if you need any more reviewers but I'd like to propose myself as one, in case my experience is useful. I'm the Font Development Technical Manager at Dalton Maag, a digital font foundry based in London. I have 10 years of experience in the type industry and a ton of experience making fonts for clients of all sizes, both as a designer as well as from a technical implementation perspective.

@siakaramalegos siakaramalegos removed the help wanted: reviewers This chapter is looking for reviewers label Apr 20, 2022
@siakaramalegos
Copy link
Member

Hi @RoelN @bramstein @svgeesus @jmsole, we still need a lead author. If we don't get one by May 1, then we'll probably have to drop the chapter so that we can focus on the viable ones. If you're willing to step up, please let us know. Or, if you could poke your font friends to try to get another volunteer, that would be helpful. My offer still stands to help with the performance stuff, if needed.

@bramstein
Copy link
Contributor

If no one comes forward before the 1st of May, I can take on the writing.

@siakaramalegos
Copy link
Member

@konfirmed just confirming @rviscomi already has your email address to set you up so you're not charged in Big Query

@konfirmed
Copy link
Contributor

@siakaramalegos I think so, but will send it to @rviscomi

@siakaramalegos
Copy link
Member

@bramstein looks like you're an author now :) Are you interested in being lead also? I sent you an email to get started. Let me know if you didn't receive it.

@bramstein
Copy link
Contributor

@siakaramalegos Indeed :) I can be lead as well. I received your email, will get back to you shortly.

@rviscomi
Copy link
Member Author

rviscomi commented May 6, 2022

@bramstein @RoelN @svgeesus @jmsole @konfirmed could you all make sure you have access to the chapter planning doc and start adding your ideas to the outline? What's new with web fonts this year, or what would be interesting to revisit from previous years? We're aiming to have the outline completed by May 15 in order to have enough time to add any needed custom metrics before the June crawl kicks off. Thanks!

@bramstein
Copy link
Contributor

@konfirmed I don't have your email. Could you send me an email to b.l.stein@gmail.com ? Thanks!

@konfirmed
Copy link
Contributor

@bramstein I sent you an email, hope you received it.

@bramstein
Copy link
Contributor

@konfirmed Got it, thanks!

@siakaramalegos
Copy link
Member

@RoelN @svgeesus @jmsole just a reminder that the outline is due in 2 days so make sure you open the doc, add your name and email to confirm your participation, and provide feedback on the outline that Bram started (scroll down to a new Ideas section). Thanks!

@siakaramalegos
Copy link
Member

@bramstein and team, is the outline complete? The deadline was May 15. We now have less than 2 weeks to finalize any custom metrics so getting to outline completion is critical. When it's complete, please check the milestone off. Thanks for your contributions!

@rviscomi rviscomi mentioned this issue May 21, 2022
35 tasks
@bramstein
Copy link
Contributor

Updated the wptagent with a new extractor for cmap, OT features, and color fonts: catchpoint/WebPageTest.agent#522

@siakaramalegos
Copy link
Member

@konfirmed and team - how is the query generation going? We want to be ready to run them once the run is finished.

@siakaramalegos
Copy link
Member

@konfirmed and team - all the data should now be ready to query. It looks like you have 3 queries written - what's your plan for finishing up the rest and starting the analysis? Do you need any help? Checking in to make sure we can keep progress toward publication

@konfirmed
Copy link
Contributor

@siakaramalegos Hi I do need help. I should be able to dedicate this coming week to writing the remaining queries

@siakaramalegos
Copy link
Member

Hi @konfirmed what kind of help do you need? Let me know here, or you can ask in the analyst channel in Slack. Depending on what it is, want to get you the right help.

@siakaramalegos
Copy link
Member

@konfirmed @bramstein it looks like the queries are almost complete - can you give us an idea of % complete and timeline on the rest? Also, you're pretty behind on the analysis so I'm getting worried about the viability of this chapter - the deadline for writing is the end of this month.

@bramstein when do you think you can begin the draft? Just as a reminder, the due date at the end of the month is for post-review and post-edit, so you'll need to set aside at least a week for those and preferably more.

@alexnj
Copy link
Member

alexnj commented Aug 17, 2022

I can be a reviewer if help is needed!

@rviscomi rviscomi removed help wanted Extra attention is needed help wanted: coauthors This chapter is looking for coauthors labels Aug 18, 2022
@siakaramalegos
Copy link
Member

@bramstein Just wanted to ping again - I noticed the PR for the queries is merged, but I don't see any data or analysis in the results sheet yet nor anything in the draft yet. What's the plan to get the analysis done and the writing complete in time for review? Thanks

@bramstein
Copy link
Contributor

@siakaramalegos Thanks for trying to keep things on track! I'm still trying to catch up. The queries have been merged and I manually saved the query results locally. I'll add the results to the sheet over the weekend. Then I'll start on the first draft.

@siakaramalegos
Copy link
Member

siakaramalegos commented Aug 19, 2022 via email

@rviscomi
Copy link
Member Author

@bramstein you might be interested in @kevinfarrugia's tool to take local CSV results and automatically import them into Sheets to streamline the process. More discussion about it in the #web-almanac-analysts channel on Slack.

@bramstein
Copy link
Contributor

@rviscomi @siakaramalegos Thanks! I went through the data today and made some writing notes for the chapter (and fixed a couple things, #3080). I've used the tool to upload the query results to Sheets.

@siakaramalegos
Copy link
Member

great job so far @bramstein and review team! What are the final steps to get the reviews done and incorporated? We'd love to get this published in the first round.

@rviscomi rviscomi added the ASAP This issue is blocking progress label Sep 3, 2022
@svgeesus
Copy link
Contributor

I just did a complete end-to-end read in one sitting and really, this is very clear, detailed, good logical flow, easy to understand. A quality chapter. I think I had like one or two tiny suggestions this time, and the chapter would be totally fine without either being changed.

@shantsis
Copy link
Contributor

Hi all, I've done a read through for editing and left a couple of suggested changes (mostly changing the tense from I to us, and some suggestions of big figures). It's looking quite good!

@tunetheweb tunetheweb mentioned this issue Sep 24, 2022
5 tasks
2022 automation moved this from In Progress to Done Sep 25, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
2022 chapter Tracking issue for a 2022 chapter ASAP This issue is blocking progress
Projects
2022
Done
Development

Successfully merging a pull request may close this issue.

9 participants