Skip to content

Conversation

kavaivaleri
Copy link
Member

@kavaivaleri kavaivaleri commented Oct 3, 2025

➡️ No H1

articles.md, books.md, events.md, index.md, people.md, podcast.md, slack.md, support.md pages and author.html, book.html layouts had no H1.

I added H1 (in practice, some of the headers were H2 and I edited them to H1).

Additional changes in author.html and book.html

I also asked Cursor to help me with SEO optimization. For author.html, book.html, it suggested several improvements.

Both files went from basic HTML to properly structured pages that search engines can understand and rank, while also being accessible to screen readers.

More about structured content JSON-LD schemas: https://docs.google.com/document/d/1xmcMOxh0glrX10Rp7vNJHXWn-ysCxISPvEEOuyUIX1k/edit?usp=sharing

author.html

Added:

  • Semantic HTML (<main>, <header>, <section>, <nav>) instead of generic <div>s
  • Proper <h1> for author name, <h2> for sections
  • Alt text on images, aria-label on links
  • JSON-LD Person schema for search engines
  • Security attributes (rel="noopener noreferrer")

Impact: Search engines understand it's a person profile; screen readers navigate properly; social links are indexed.

book.html

Added:

  • JSON-LD Book schema with author, publisher, purchase links
  • Fixed heading hierarchy: <h1> for title (was <h2>), <h2> for authors (was <h4>)
  • Semantic structure: <article>, <section>, <header>, <footer>
  • Image optimization: alt text, lazy loading, Schema.org microdata
  • Q&A sections use <article> + proper headings (not just bold text)

Impact: Google can show rich snippets with book covers and buy buttons; better SEO rankings from proper H1/H2 structure; faster page loads from lazy loading.

Source: https://docs.google.com/spreadsheets/d/1CEgWo8nQWZrRMBQnpHe8MhNoT_mWzux7GWJlSFflEP0/edit?usp=sharing

➡️ Duplicate title tags

These pages had duplicate title tags:

I updated each of them to have unique titles.

For blog posts listed here, I also:

  • Added/improved alt text for images
  • Created better content structure for readability

Source: https://docs.google.com/spreadsheets/d/13mUpkejeRKGXiydaQl7lm4O9xJOY6W4W3x-r5dTSqFk/edit?usp=sharing

➡️ Duplicate meta descriptions

These pages had duplicate meta descriptions:

I updated each of them to have unique meta descriptions.

Source: https://docs.google.com/spreadsheets/d/1y4h-i78ulL_ws_fM-XZMJbEE0KNSbcVw33AE-bYiFuk/edit?usp=sharing

➡️ Thin content

These pages had thin content, meaning less than 200 words:

For these podcasts, I added short versions of the podcasts because there were no transcripts available. To show you what short versions could look like:

For books, I expanded descriptions.

…ved descriptions, structured data, and semantic HTML elements.
… enhance clarity and SEO and remove duplicate_title_tags
…o images, enhancing descriptions, and refining content structure for better readability and SEO.
…criptions, adding structured sections, and clarifying roles and processes in data science teams. Updated links and ensured consistency in formatting for better readability and SEO.
…ed clarity and SEO. Added written versions of the podcasts.
@alexeygrigorev alexeygrigorev merged commit ec942d3 into main Oct 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants