HTTPArchive / almanac.httparchive.org

HTTP Archive's annual "State of the Web" report made by the web community
https://almanac.httparchive.org
Apache License 2.0
613 stars 173 forks source link

Write content: Chapter 10. SEO #163

Closed rviscomi closed 5 years ago

rviscomi commented 5 years ago
Part Chapter Authors Reviewers Analysts Metrics Analysis
II. User Experience 10. SEO @rachellcostello @ymschaap @AVGP @clarkeclark @andylimn @voltek62 @AymenLoukil @catalinred @ymschaap #12 #91

Due by: October 7

Refer to the Authors' Guide for writing advice.

ymschaap commented 5 years ago

@rachellcostello @AVGP is it an idea to setup a call (hangout, zoom) together to discuss how to get started on this? If so, drop me your e-mail so we can set a date in calendar.

ymschaap commented 5 years ago

I've made a quick outline on the content:

https://github.com/HTTPArchive/almanac.httparchive.org/commit/27a6adc68eb06abfb8f1d11bf3f13a86f681873e

Also @rachellcostello @AVGP: reminder of my idea to setup a call together.

AVGP commented 5 years ago

@ymschaap I'd be available for a call this week or next week :)

ymschaap commented 5 years ago

Ok, I've sent an email with dates.

@rviscomi when is the new deadline for the content? https://docs.google.com/spreadsheets/d/1LR29JpI2XJSjan_z6uP1YpRy4EYYivYZPqCIG-9sfFY/ shows we are behind on schedule. Maybe provide on update on that?

rviscomi commented 5 years ago

The current milestones and schedule sheet are correct: October 7 is the target deadline for at least the first draft, ideally final draft.

clarkeclark commented 5 years ago

@rviscomi I know it's really late, but would it be possible to get the distribution of the length of the first H1 tag across sites? I'd settle for regex.

rviscomi commented 5 years ago

Added as metric 10_16: https://docs.google.com/spreadsheets/d/1uARtBWwz9nJOKqKPFinAMbtoDgu5aBtOhsBNmsCoTaA/edit#gid=758241096

rachellcostello commented 5 years ago

My apologies @ymschaap and @AVGP - I've just returned from annual leave so have been catching up on everything this morning! I've sent you my email address Yvo, but 9:00-12:00 BST tomorrow or 13:30-15:00 BST Friday are the best time slots for me this week. I'll also be available next week.

rviscomi commented 5 years ago

Just checking in to say I'm happy to see this moving along! Thanks everyone for your help getting this launched on time! 🤜💥 🤛

ymschaap commented 5 years ago

@rviscomi, two questions:

rviscomi commented 5 years ago

do we already have to think about the charts/tables? Or are those added later? E.g. we just add placeholders?

For now placeholders would be great. You could generate a simple chart in Sheets and drop that in as an indicator of what you're trying to convey or just <insert bar chart of metric 10.01 here> for example. We're still working on the design of the data viz and will be applying that across all chapters for consistency.

Are the general limitations of the web crawl already laid out to the reader (e.g. homepage only, not a Google project, etc) or do we need to emphasise those as well?

There will be a universal Methodology page that generally explains how HTTP Archive works and how we analyzed the data for the Almanac. It's a good idea for authors to have their own brief Methodology section to explain the scope and limitations of the chapter's analysis. For example, some metrics might only be available for mobile because they depend on Lighthouse metrics, so that would be good to remind readers.

Thanks for the questions, these would be great to include in the Author's Guide.

rviscomi commented 5 years ago

@ymschaap @AVGP @rachellcostello have you made any progress on the action items in https://github.com/HTTPArchive/almanac.httparchive.org/issues/163#issue-494397228? Also let me know if you have a doc of the chapter draft I could look at. Thanks everyone!

AVGP commented 5 years ago

Sorta. We have a shared doc where we take notes (I shared it with you) and once we got everything together, we will put that into a proper draft, proofread and get it in as a PR.

ymschaap commented 5 years ago

@AVGP @rachellcostello look at what Chapter 12 made:

https://docs.google.com/document/d/1ypPGDyvpWJcil1bNuvq3D8DXcwjHN00NX2iYQtU70oo/edit#heading=h.jcincmxdwr3s

I personally:

Can I do anything for the parts you got assigned? Or maybe already get our Reviewers onboard by sharing our draft here?

rachellcostello commented 5 years ago

Thanks for sharing this, it's useful to see another chapter as a reference point! And I completely agree with you.

Now that the structure is there, I'll write up a second draft today and will add in relevant links.

Would you be able to add in some placeholder charts @ymschaap? :)

ymschaap commented 5 years ago

Ok, to move things forward I've followed the style of chapter 12 a bit and changed the order and tried to add more context to the metrics we discuss.

I'll also work on the Advanced topic, given that is still not finished, but I can finish that tonight.

Hello @clarkeclark @andylimn @voltek62. Your help is much appreciated to make this into an amazing chapter. Specific:

Things between brackets are a WIP.

Help us by:

cc @rviscomi

clarkeclark commented 5 years ago

@ymschaap Will review this evening

clarkeclark commented 5 years ago

@ymschaap just requested access to the draft

ymschaap commented 5 years ago

@clarkeclark made the draft link above public. Have access now?

clarkeclark commented 5 years ago

@ymschaap still can't access. Pls invite me directly via jfox@venturemarketing.com

andylimn commented 5 years ago

@ymschaap same here, could you invite me too please and I'll take a look today (andrew.limn@artefact.com). Thanks

AymenLoukil commented 5 years ago

Hello ! I can give a hand if you want :) aymen.loukil@gmail.com

catalinred commented 5 years ago

Hi all,

I'd be happy to help review this awesome resource you're working on!

rviscomi commented 5 years ago

Thanks @AymenLoukil and @catalinred! I've added you both as reviewers for this chapter.

@catalinred I've also sent you an invitation to join the Reviewers team. You can go to https://github.com/HTTPArchive to accept. Thanks again!

catalinred commented 5 years ago

Thank you @rviscomi

Sorry for being so late to the party, @rachellcostello @ymschaap @AVGP I'll do my best to help you out with this!

Also, what is the preferred method to share the feedback/thoughts on the above spreadsheet and draft? Email / slack channel / this thread?

rviscomi commented 5 years ago

@catalinred feedback can be provided in the draft doc as inline comments.

clarkeclark commented 5 years ago

@ymschaap just reviewed current draft. Aside from decisions on what to include wrt AMP, it's good to go for me. Thanks for the opportunity to help out.

rviscomi commented 4 years ago

@ymschaap @rachellcostello @AVGP apologies for the delay, this was a hectic week! Your chapter is now edited and visualized at https://almanac.httparchive.org/en/2019/seo. It should now have responsive and accessible data visualizations. File a bug if you see anything wonky. I've removed the "unedited" tag.