feat: publish new JS course #1907

honzajavorek · 2025-09-08T14:10:53Z

The aim of this PR is to publish the new JS course as described in the PR description of #1584, and to unlist the old JS course. The old one should be still accessible for a grace period.

Replacing the old JS course with a new one, which is identical to the Python course, has been previously sanctioned by both Ondra and Michał.

The Plan

The scraping_basics_javascript root leads to the new JS course.
The pages of the old JS course move to legacy/web-scraping-for-beginners. It's gonna be a read-only archive. Must be noindex to avoid cannibalization issues.
The web-scraping-for-beginners, i.e. the root of the old JS course URLs, leads to redirects which take people to corresponding pages in the new JS course. This lets us use the SEO juice from the old URLs.
The redirects add #old-js-course to the URL. The new JS course pages contain a component which, if #old-js-course is present in the URL, displays a commemorative plaque about the change and link the old JS course. This improves UX: "Hey, you have until 1.1.2026 to go through this course. After that please refer to the newly updated JS course ."
At some point in future, we'll nuke the archive of the old JS course and link Internet Archive instead in the commemorative plaque.

The Plan is a result of a long discussion between Michał, Aleš, and me, which takes into account both the UX of existing users of the JS course and SEO.

Related Work

Note

Publishes the new JS course, archives the old one with redirects and an on-page notice, and updates links, content, and Nginx rewrites across the docs.

Academy: New JS course rollout
- Publishes academy/webscraping/scraping_basics_javascript/* (new slugs, content, and index) and updates internal references to it.
- Archives the old JS course under academy/webscraping/scraping_basics_legacy/* with noindex and a legacy notice.
- Adds src/components/LegacyJsCourseAdmonition.jsx and integrates it into new course pages to show a notice when ?legacy-js-course= is present.
- Updates course metadata (titles/sidebar labels) in Expert/Anti‑scraping lessons and adds caution notes where content depends on the legacy course.
- Updates homepage card and other references to point to '/academy/scraping-basics-javascript'.
Routing/Redirects (Nginx)
- Redirects old JS course paths ^/academy/web-scraping-for-beginners... to '/academy/scraping-basics-javascript' with ?legacy-js-course=....
- Adds other redirects (e.g., output-schema → dataset-schema, academy php path, advanced web scraping path fix).
Content/link maintenance
- Repoints numerous lessons to new paths (e.g., tutorials, Puppeteer/Playwright, advanced courses) and updates sample URLs in integrations (Make) to the new JS course.
- Minor copy/heading tweaks (e.g., RPA title), and consistent slug/slug changes across documents.

^{Written by Cursor Bugbot for commit 2840ebd. Configure here.}

apify-service-account · 2025-10-15T12:37:56Z

Preview for this PR was built for commit 2c5b0c2 and is ready at https://pr-1907.preview.docs.apify.com!

apify-service-account · 2025-10-15T13:35:54Z

Preview for this PR was built for commit ce9758b2 and is ready at https://pr-1907.preview.docs.apify.com!

apify-service-account · 2025-10-15T14:06:48Z

Preview for this PR was built for commit 717e49c7 and is ready at https://pr-1907.preview.docs.apify.com!

apify-service-account · 2025-10-16T07:42:05Z

Preview for this PR was built for commit a24ff8e5 and is ready at https://pr-1907.preview.docs.apify.com!

apify-service-account · 2025-10-16T07:52:06Z

Preview for this PR was built for commit b2726ec0 and is ready at https://pr-1907.preview.docs.apify.com!

apify-service-account · 2025-10-16T07:56:44Z

Preview for this PR was built for commit 04754526 and is ready at https://pr-1907.preview.docs.apify.com!

apify-service-account · 2025-10-16T08:01:47Z

Preview for this PR was built for commit 10f13d0b and is ready at https://pr-1907.preview.docs.apify.com!

apify-service-account · 2025-10-16T08:11:06Z

Preview for this PR was built for commit 92d189a and is ready at https://pr-1907.preview.docs.apify.com!

honzajavorek · 2025-11-18T13:22:11Z

I'm getting a ton of conflicts after #2056 merged before this one 😞

apify-service-account · 2025-11-19T14:49:54Z

Preview for this PR was built for commit 2840ebd and is ready at https://pr-1907.preview.docs.apify.com!

honzajavorek · 2025-11-19T14:50:53Z

Conflicts resolved!

sources/academy/glossary/tools/apify_cli.md

sources/academy/platform/expert_scraping_with_apify/solutions/integrating_webhooks.md

sources/academy/platform/expert_scraping_with_apify/actors_webhooks.md

sources/academy/webscraping/anti_scraping/mitigation/using_proxies.md

sources/academy/webscraping/scraping_basics_legacy/index.md

apify-service-account · 2025-11-21T09:43:05Z

Preview for this PR was built for commit e7745879 and is ready at https://pr-1907.preview.docs.apify.com!

apify-service-account · 2025-11-21T09:46:00Z

Preview for this PR was built for commit 8b000c73 and is ready at https://pr-1907.preview.docs.apify.com!

apify-service-account · 2025-11-21T09:49:03Z

Preview for this PR was built for commit 8b000c73 and is ready at https://pr-1907.preview.docs.apify.com!

TC-MO

LGTM 🚀

honzajavorek · 2025-11-21T10:11:07Z

This deserves a song! (do not click the image, you've been warned)

honzajavorek · 2025-11-21T10:16:31Z

nginx.conf

    rewrite ^/platform/actors/development/testing-and-maintenance$ /platform/actors/development/deployment/automated-tests redirect;
    rewrite ^/platform/actors/development/source-code$             /platform/actors/development/deployment/source-types redirect;

+    # Rename output schema to dataset schema


@TC-MO I think this part is a leftover from the rebase as well 👀 I'll remove it.

…th the original URL in query

Co-authored-by: Michał Olender <[email protected]>

apify-service-account · 2025-11-21T10:23:29Z

Preview for this PR was built for commit 0164c83 and is ready at https://pr-1907.preview.docs.apify.com!

honzajavorek changed the title ~~feat: publish the JS course~~ feat: publish new JS course Sep 8, 2025

This was referenced Sep 8, 2025

feat: use the Python course as a template for a new JavaScript course #1584

Closed

feat: re-structure the JS course so that it's a flat list of numbered lessons #1579

Closed

honzajavorek added the t-academy Issues related to Web Scraping and Apify academies. label Sep 8, 2025

honzajavorek mentioned this pull request Oct 14, 2025

feat: add conditional admonition component #2009

Closed

honzajavorek force-pushed the honzajavorek/publish-js-course branch from 3ea45eb to 2c5b0c2 Compare October 15, 2025 12:34

honzajavorek mentioned this pull request Oct 16, 2025

style: few fixes to make linters happy #2023

Open

honzajavorek marked this pull request as ready for review October 16, 2025 08:07

honzajavorek requested a review from TC-MO as a code owner October 16, 2025 08:07

honzajavorek force-pushed the honzajavorek/publish-js-course branch from 10f13d0 to 92d189a Compare October 16, 2025 08:08

honzajavorek force-pushed the honzajavorek/publish-js-course branch from 92d189a to 2840ebd Compare November 19, 2025 14:46

TC-MO requested changes Nov 21, 2025

View reviewed changes

TC-MO approved these changes Nov 21, 2025

View reviewed changes

honzajavorek commented Nov 21, 2025

View reviewed changes

refactor: put old course to legacy folder

be7dcf3

honzajavorek and others added 26 commits November 21, 2025 11:17

feat: put the new course to the /scraping-basics-javascript/ URL

faec8c6

fix: edit links to the JS course

8cc5d97

feat: change URLs of the legacy JS course

d5be426

fix: leftover, correct URL for the course root

5d7613d

feat: redirects from original URLs to the new JS course's lessons, wi…

89153f5

…th the original URL in query

feat: set new sidebar position

d1449e3

feat: unlist the legacy JS course

9944a4a

feat: implement and use the LegacyJsCourseAdmonition component

49bc198

fix: pretend that this is an updated example output

17d4cda

fix: update various links leading to the old course

46b760e

feat: denote that the old course is old

b9e1c0b

fix: do not set the old JS course as unlisted, set as noindex instead

477a6dc

feat: publish the new JS course

5d3e89f

style: make linters happier

edc0f60

feat: add admonition to all old course pages

a4e9a76

style: make Vale happy about Gzip

694df54

style: make Vale happy about H1s

60fe380

style: make Vale happy about H1s

88d2b3e

style: make Markdown lint happy

f863858

fix: typo

0319233

Co-authored-by: Michał Olender <[email protected]>

style: raw markdown clarity

a02247e

Co-authored-by: Michał Olender <[email protected]>

style: raw markdown clarity

071a6f7

Co-authored-by: Michał Olender <[email protected]>

style: raw markdown clarity

b521a2b

Co-authored-by: Michał Olender <[email protected]>

style: don't use question marks in headings

d4d9790

Co-authored-by: Michał Olender <[email protected]>

style: don't title case headings (consistency)

99c7c23

Co-authored-by: Michał Olender <[email protected]>

fix: remove leftover from git rebase

0164c83

honzajavorek force-pushed the honzajavorek/publish-js-course branch from 8b000c7 to 0164c83 Compare November 21, 2025 10:20

honzajavorek merged commit d3406ef into master Nov 21, 2025
11 checks passed

honzajavorek deleted the honzajavorek/publish-js-course branch November 21, 2025 10:25

feat: publish new JS course #1907

feat: publish new JS course #1907

Uh oh!

Conversation

honzajavorek commented Sep 8, 2025 • edited by cursor bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

The Plan

Related Work

Uh oh!

apify-service-account commented Oct 15, 2025

Uh oh!

apify-service-account commented Oct 15, 2025

Uh oh!

apify-service-account commented Oct 15, 2025

Uh oh!

apify-service-account commented Oct 16, 2025

Uh oh!

apify-service-account commented Oct 16, 2025

Uh oh!

apify-service-account commented Oct 16, 2025

Uh oh!

apify-service-account commented Oct 16, 2025

Uh oh!

apify-service-account commented Oct 16, 2025

Uh oh!

honzajavorek commented Nov 18, 2025

Uh oh!

apify-service-account commented Nov 19, 2025

Uh oh!

honzajavorek commented Nov 19, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

apify-service-account commented Nov 21, 2025

Uh oh!

apify-service-account commented Nov 21, 2025

Uh oh!

apify-service-account commented Nov 21, 2025

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

honzajavorek commented Nov 21, 2025

Uh oh!

honzajavorek Nov 21, 2025

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Nov 21, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

honzajavorek commented Sep 8, 2025 •

edited by cursor bot

Loading