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

2020 SEO chapter #1589

Merged
merged 31 commits into from
Dec 2, 2020
Merged

2020 SEO chapter #1589

merged 31 commits into from
Dec 2, 2020

Conversation

antoineeripret
Copy link
Contributor

@antoineeripret antoineeripret commented Nov 28, 2020

Closes #908

  • - Add chapter in Markdown
  • - Add 25 out of 25 images
  • - Review contributors (Authors, Reviewers, Analysts) in meta data, ensuring all contributors are listed in order of contribution and removing those that were unable to make a meaningful contribution.
  • - Add all Author Bios to meta data
  • - Add Featured Quote, 3 interesting stats and labels in meta data
  • - Finish all TODOs

antoineeripret and others added 2 commits November 28, 2020 22:59
Add 25 out of 25 images for the SEO (2020) chapter.
@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 42.2%, saving 343.59 KB.

Filename Before After Improvement Visual comparison
src/static/images/2020/seo/fig1_on_page_robots_directive_use.png 23.74 KB 11.88 KB -50.0% View diff
src/static/images/2020/seo/fig10_meta_description_word_length.png 29.88 KB 16.95 KB -43.3% View diff
src/static/images/2020/seo/fig11_meta_description_character_length.png 33.51 KB 19.20 KB -42.7% View diff
src/static/images/2020/seo/fig12_img_tags_per_page.png 27.49 KB 15.27 KB -44.5% View diff
src/static/images/2020/seo/fig13_percent_of_missing_img_alt_attribute.png 24.92 KB 12.87 KB -48.4% View diff
src/static/images/2020/seo/fig14_percent_of_img_alt_attributes_present.png 27.00 KB 14.20 KB -47.4% View diff
src/static/images/2020/seo/fig15_percent_of_img_alt_attributes_blank.png 24.80 KB 12.89 KB -48.0% View diff
src/static/images/2020/seo/fig16_outgoing_links.png 26.87 KB 14.77 KB -45.0% View diff
src/static/images/2020/seo/fig17_outgoing_links_internal.png 29.04 KB 16.35 KB -43.7% View diff
src/static/images/2020/seo/fig18_outgoing_links_external.png 26.79 KB 14.73 KB -45.0% View diff
src/static/images/2020/seo/fig19_text_links.png 27.55 KB 15.35 KB -44.3% View diff
src/static/images/2020/seo/fig2_presence_of_canonical_tag.png 25.50 KB 13.26 KB -48.0% View diff
src/static/images/2020/seo/fig20_nofollow_ugc_sponsored_attributes.png 31.52 KB 17.82 KB -43.5% View diff
src/static/images/2020/seo/fig21_image_links.png 34.31 KB 19.60 KB -42.9% View diff
src/static/images/2020/seo/fig22_lighthouse_v5_vs_v6.png 74.99 KB 45.26 KB -39.6% View diff
src/static/images/2020/seo/fig23_good_core_web_vitals_score_per_device.png 26.73 KB 13.84 KB -48.2% View diff
src/static/images/2020/seo/fig24_aggregate_cwv_performance_by_country.png 52.50 KB 36.15 KB -31.1% View diff
src/static/images/2020/seo/fig25_percent_of_https.png 47.01 KB 28.98 KB -38.4% View diff
src/static/images/2020/seo/fig3_canonical_implementation_method.png 29.13 KB 24.18 KB -17.0% View diff
src/static/images/2020/seo/fig4_visible_words_per_page_raw.png 32.78 KB 18.74 KB -42.8% View diff
src/static/images/2020/seo/fig5_visible_words_per_page_rendered.png 32.65 KB 18.61 KB -43.0% View diff
src/static/images/2020/seo/fig6_presence_of_h_tag.png 40.37 KB 23.37 KB -42.1% View diff
src/static/images/2020/seo/fig7_presence_of_non_empty_h_tags.png 28.60 KB 14.95 KB -47.7% View diff
src/static/images/2020/seo/fig8_title_word_count.png 27.15 KB 15.02 KB -44.7% View diff
src/static/images/2020/seo/fig9_title_character_count.png 29.49 KB 16.51 KB -44.0% View diff

405 images did not require optimisation.

@tunetheweb tunetheweb changed the title Add 2020/SEO images 2020 SEO chapter Nov 28, 2020
@tunetheweb tunetheweb added the writing Related to wording and content label Nov 28, 2020
@tunetheweb tunetheweb added this to the 2020 Content Writing milestone Nov 28, 2020
@rviscomi
Copy link
Member

@antoineeripret @bazzadp is this PR meant to contain all of the chapter markdown or is this just a head start to get the figure images checked in?

@tunetheweb
Copy link
Member

@rviscomi I thin we should do both in the same PR as they are linked. That way any image changes needed as we work on Chapter can be captured in this PR - for example I'd like to remove the figX from the beginning of the numbers. Will add an initial version of the markdown to this branch, check it's all working, and then let the authors finish it off.

@tunetheweb tunetheweb mentioned this pull request Nov 29, 2020
10 tasks
@tunetheweb
Copy link
Member

tunetheweb commented Nov 29, 2020

I've converted the chapter to Markdown. This is quite a manual process so please double check I didn't miss anything. I had to make some changes (for example we don't use nested lists like was in the Performance section and in the Conclusion) so converted those as best as I saw fit.

I pushed a test version of the chapter here: https://20201129t114634-dot-webalmanac.uk.r.appspot.com/en/2020/seo

aleyda @ipullrank @fellowhuman1101 @clarkeclark @natedame @catalinred @aysunakarsu @ashleyish @dsottimano @dwsmart @en3r0 @Gathea @rachellcostello and @ibnesayeed Can you all review please? As a reminder there will be an Editing stage after this so concentrate on the actual content rather than phrasing for now.

For those not familiar with GitHub, the content is in the File tab at the top, and you are looking for the seo.md file:

seo.md

GitHub will probably not show it by default as it's quite big but click 'Load Diff' to see it:

image

You will see changes from the original template on the left, and new version on the right with removals in red, and additions in green.

You can edit the Markdown using the drop down in the top right:

Edit a while file in GitHub

Probably better that @aleyda is the only one who edits it now, and the rest of you suggest changes instead. To suggest changes click on a line, where you'll be able to add a comment:

Adding review comment

You can then add that single comment, or Start a Review, which batches up all your comments and then releases them in one go (better to do this when you want to have a few comments to save spamming everyone).

You can use the suggest feature by using the button in the toolbar, and it will insert the current text which you can edit:

Suggest edit

And then click on the Preview tab and you'll see what it looks like:

Preview

Once you submit a single comment, or a review it will be put in this main conversation tab and everyone will be alerted to it.

It's actually quite a nice way of working once you are used to it. Any questions give me a shout!

src/content/en/2020/seo.md Outdated Show resolved Hide resolved
Comment on lines 11 to 12
#aleyda_bio: TODO
#ipullrank_bio: TODO
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aleyda , @ipullrank , @fellowhuman1101 can you add your Bios here which will appear at the bottom of the chapter? They should use HTML and not Markdown.

See last year's chapter as examples.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @bazzadp ! I just added mine ... and now I'm seeing that they should use HTML and not markdown (I had used markdown). I will change that now :D

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you also remove the initial # as that is currently commenting out your bio since it wasn't there previously.

This is what it looks like when you do that:

aleyda bio

I think it should be Twitter rather than twitter btw.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@bazzadp thanks Barry! Just to confirm that I did this :)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's better. Did you see my comment about uppercasing the T in Twitter?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@bazzadp I hadn't! Thanks for the heads up :D Just fixed it.

@@ -23,3 +23,835 @@ queries: 07_SEO
#featured_stat_label_3: TODO
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aleyda can you think of a nice quote and three featured stats to entice people into the chapter. These will appear randomly on the home page.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @bazzadp, thanks for asking :)

@ipullrank @fellowhuman1101 - what do you think to include for:

  • The main quote: "The link discoverability for major JS frameworks used for SPAs increased dramatically compared to 2019. By testing mobile navigation links for hashed URLs, we saw -53% instances of uncrawlable links from sites using React, -58% fewer from Vue.js powered sites, and a -91% reduction from Angular SPAs."

  • The 3 featured stats:

  1. 10.84% of mobile home pages and 16.18% of desktop ones are not including the viewport tag at all, suggesting that they are not yet mobile friendly.

  2. 33.13% of websites scored 'Good' Core Web Vitals for desktop while only 19.96% of their mobile counterparts passed the Core Web Vitals assessment.

  3. The median mobile site displays 11.5% more words when rendered than its raw HTML, showing a reliance on client side JavaScript to show web pages content.

Let me know what you think of these or if you would prefer to highlight other stats/findings! Thanks :)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aleyda I think the main quote talks about what's gotten better, but we should consider using our main quote as the opportunity to alert people to the big problem of their being a disparity between mobile and desktop.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ipullrank I see what you mean... especially due to the Mobile First Index. What about:

"Despite the growing use of mobile devices and Google’s move to a Mobile first index, non-trivial disparities were found across mobile vs. desktop pages, like the one between mobile and desktop links, illustrated in the 62 links on mobile versus the 68 links on desktop for the median web page."?

cc @fellowhuman1101

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aleyda muy bien para mi

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ipullrank gracias Mike!

@fellowhuman1101 Is it good for you too Jamie? :)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aleyda Looks good!

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the confirmation @fellowhuman1101 :)

@bazzadp @rviscomi I just added the quote and stats and submitted them here. I noticed there were "labels" for them but didn't know what should I add there. Could you please let me know to include them too if necessary? :) Thanks again

Copy link
Member

@rviscomi rviscomi Dec 4, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks everyone! I've followed up in the linked PR about the next steps to get this included. To summarize, let's apply any further changes directly to the open PR to keep everything in one place.

BTW @fellowhuman1101 there's a TODO in the PR for you to add your bio, and I've also sent you an invite to join the Authors Team on GitHub, so we can assign issues/PRs to you.

Edit: Nevermind on the TODO! That's what I get for reading notification in sequential order 😁 but you've still got that pending invite.

src/content/en/2020/seo.md Outdated Show resolved Hide resolved
@aleyda
Copy link
Contributor

aleyda commented Nov 29, 2020

Thanks SO much for generating the Markdown and all the explanations @bazzadp - this is amazing! Will start reviewing, adding my bio, and checking to make sure that the reviewers who have participated are listed too :) I'll let you know if I have any questions... thanks again for all your help! cc @ipullrank @fellowhuman1101

@tunetheweb
Copy link
Member

No problem. Keen to get the chapter into editing as it’s a big one!

Also have a search through the markdown for the phrase “TODO” as there’s a few in there.

Move the pull request out of Draft when you think it’s ready to merge and will have another look over it.

Copy link
Contributor

@ibnesayeed ibnesayeed left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I skimmed through the rendered page and things look good to me other than stylistic and editorial issues.

I thought of an alternate representation of how we report statistics on headings (H1..H6) in SEO or Markup chapters that encapsulates their hierarchical distribution, but it is too late to incorporate that now for this year.

I am wondering, should the description of figures be visible by default on large screens?

src/content/en/2020/seo.md Outdated Show resolved Hide resolved
src/content/en/2020/seo.md Outdated Show resolved Hide resolved
@tunetheweb
Copy link
Member

I thought of an alternate representation of how we report statistics on headings (H1..H6) in SEO or Markup chapters that encapsulates their hierarchical distribution, but it is too late to incorporate that now for this year.

Possibly getting a little late, but keen to hear more about your idea anyway?

I am wondering, should the description of figures be visible by default on large screens?

No think that would be repetitive. They are meant as additional content for visually impaired who maybe can’t appreciate the graphs (they are also linked with aria-describedby for screen readers).

translators: []
#aleyda_bio: TODO
aleyda_bio: SEO consultant, author, speaker and entrepreneur. Founder of <a href="https://www.orainti.com/">Orainti</a> (a boutique SEO consultancy working with some of the top Web properties and brands, from SaaS to marketplaces) and co-founder of <a href="https://remoters.net/">Remoters.net</a> (a free remote work hub, featuring remote jobs, tools, events, guides, and more to facilitate remote work). Aleyda enjoys sharing about SEO through her <a href="https://www.aleydasolis.com/en/blog/">blog</a>, the <a href="https://www.aleydasolis.com/en/seo-tips/">#SEOFOMO newsletter</a>, the <a href="https://www.aleydasolis.com/en/crawling-mondays-videos/">Crawling Mondays</a> video and podcast series and over <a href="https://twitter.com/aleyda">Twitter</a>.
#ipullrank_bio: TODO
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ipullrank could you suggest a bio?

translators: []
#aleyda_bio: TODO
aleyda_bio: SEO consultant, author, speaker and entrepreneur. Founder of <a href="https://www.orainti.com/">Orainti</a> (a boutique SEO consultancy working with some of the top Web properties and brands, from SaaS to marketplaces) and co-founder of <a href="https://remoters.net/">Remoters.net</a> (a free remote work hub, featuring remote jobs, tools, events, guides, and more to facilitate remote work). Aleyda enjoys sharing about SEO through her <a href="https://www.aleydasolis.com/en/blog/">blog</a>, the <a href="https://www.aleydasolis.com/en/seo-tips/">#SEOFOMO newsletter</a>, the <a href="https://www.aleydasolis.com/en/crawling-mondays-videos/">Crawling Mondays</a> video and podcast series and over <a href="https://twitter.com/aleyda">Twitter</a>.
#ipullrank_bio: TODO
#fellowhuman1101_bio: TODO
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@fellowhuman1101 could you suggest a bio?

@rviscomi rviscomi marked this pull request as ready for review December 1, 2020 02:15
@rviscomi
Copy link
Member

rviscomi commented Dec 1, 2020

Marking this as ready for review since this is almost ready to merge. I think once the metadata is in (bios, featured quote/stats) we can merge it and open up a new PR for editing. Any outstanding TODOs can be resolved as suggestions by the content team in the editing PR.

@aleyda
Copy link
Contributor

aleyda commented Dec 1, 2020

Wow! Something very important @ipullrank - when reviewing the content section I realized there was no "structured data" info in there ... which is in the outline as part of the content section, and was also gathered here.! I don't know how we had all missed this before when writing/reviewing that section... but it can not be left out :( it was included last year too.. Mike, since you were in charge of the content section, could you please add it in the gdocs and let me know as soon as you have so I can take it to markdown? If you're not available to do it today, could you please let me know to do it myself? Thanks in advance!

cc @bazzadp @fellowhuman1101 @rviscomi @Tiggerito @antoineeripret

@ipullrank
Copy link
Contributor

ipullrank commented Dec 1, 2020

@aleyda no problem. I got it when I wake up (it's 4:45 am here). Is there data for this?

@aleyda
Copy link
Contributor

aleyda commented Dec 1, 2020

@ericwbailey no problem. I got it when I wake up (it's 4:30 am here). Is there data?

Thanks @ipullrank - really appreciate it !! and yes, here's the data in the Google Sheets: - in two sheets:

  • pages_wpt_bodies_structured_data_by_device_and_type.sql
  • pages_wpt_bodies_structured_data_by_device_and_format.sql

Thanks in advance! As soon as you have it in the Gdocs ping me please so I can convert it to markdown and merge to see how it looks ... if it has graphs then ping also @antoineeripret / @Tiggerito too please!

Thanks :)

@tunetheweb tunetheweb mentioned this pull request Dec 1, 2020
22 tasks
@ipullrank
Copy link
Contributor

@bazzadp I'm working on the Structured Data section here. I'm looking to compare some of the features to the 2019 data, but only the top 5 was highlighted in the write up for last year. @aleyda recommended I contact you to see if you knew where I could find the spreadsheet for the structured data section of 2019. Please advise. Thanks!

@rviscomi
Copy link
Member

rviscomi commented Dec 1, 2020

@ipullrank see here. You can also find the link to the 2019 results at the bottom of the chapter
image

@ipullrank
Copy link
Contributor

@ipullrank see here. You can also find the link to the 2019 results at the bottom of the chapter
image

Excellent! Thank you.

ipullrank and others added 2 commits December 1, 2020 23:22
It's a tremendous bio!
cc @ipullrank - I reworded a bit/did minor changes and asked @catalinred and @ibnesayeed to review (as I saw they were connected in Gdocs) so it might go through additional changes.... but it good to have it here already :D Thanks for the fast, awesome effort Mike!
@aleyda
Copy link
Contributor

aleyda commented Dec 2, 2020

Thanks for the fast and awesome work on the structured data section @ipullrank ! You rock :) I just reworded a bit and asked @catalinred and @ibnesayeed to revise (their revision is in progress), however, I already took it to markdown here. and if there are any further changes I will do them there. Thanks again!

@aleyda
Copy link
Contributor

aleyda commented Dec 2, 2020

I just wanted to confirm that I've now incorporated changes based on @catalinred and @ibnesayeed comments that I saw viable to add.

See here in the doc and here in the markdown version (both updated).

cc @ipullrank you might want to take a look ... just in case :)

@tunetheweb
Copy link
Member

I did another test deploy here: https://20201202t114418-dot-webalmanac.uk.r.appspot.com/en/2020/seo

We good to merge this and pick up any further changes during editing?

@aleyda
Copy link
Contributor

aleyda commented Dec 2, 2020

https://20201202t114418-dot-webalmanac.uk.r.appspot.com/en/2020/seo

Hi @bazzadp , thank you very much! I revised again and realized the structured data objects didn't have the "code" format which I just added and then also included some structured data findings in the conclusions.

Once that @fellowhuman1101 I think we should be good to merge! I wouldn't like her bio to be left out from it.

@tunetheweb
Copy link
Member

OK Merging as still an opportunity to finish the TODOs in editing. Thanks all looks great and just one more step and we're good for the launch!

@tunetheweb tunetheweb merged commit 8c77053 into main Dec 2, 2020
@tunetheweb tunetheweb deleted the seo-chapter-2020 branch December 2, 2020 15:10
@aleyda
Copy link
Contributor

aleyda commented Dec 2, 2020

Hi @bazzadp,

I'm seeing there's something a bit outdated already in the AMP section that would be great to replace... but I can't do it myself anymore. It's the change of non-AMP content being able to be shown in Google's top stories since May 2021, which was announced back in November (before it was included but without a specific date):

Here's the current paragraph:

"Additionally, AMP is at the moment a requirement to be featured in Google’s Top Stories carousel in mobile search results–which is an important feature for news related publications, although this is expected to change sometime next year to be replaced by the new page experience metric, that will become a ranking factor for Top Stories, which was announced by Google earlier this year."

Here's the new:

"Additionally, AMP is at the moment a requirement to be featured in Google’s Top Stories carousel in mobile search results–which is an important feature for news related publications. However, this will change in May next year, when non-AMP content will become eligible as long as it meets the Google News content policies and provides a great page experience as announced by Google in November this year."

Would it be possible to replace this text?

Thanks :)

@tunetheweb
Copy link
Member

tunetheweb commented Dec 2, 2020

Doubt this’ll be the last thing you wanna tweak, if you’re anything like me, so let’s show you how to do it yourself:

That should open a new pull request for this edit which @rviscomi or I will review and then accept. Small pull requests like this are quite normal and how git works. It’s the large pull requests for whole chapters that are unusual 😉

So go ahead and do this one to get yourself used to this flow, as editing has not started yet. However after that, it’s then best to leave your other changes for during the editing pull request so that you don’t end up both changing the same text in git, which requires a bit of extra effort to resolve the “merge conflict”.

@aleyda
Copy link
Contributor

aleyda commented Dec 2, 2020

Thanks @bazzadp, really appreciate your help! I just did it :D Hopefully there won't be that many new changes! Thanks again

@aleyda aleyda mentioned this pull request Dec 4, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
writing Related to wording and content
Projects
None yet
Development

Successfully merging this pull request may close these issues.

SEO 2020
7 participants