From d09810a2887a238026d5d65b5376f03d7b177946 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Olender?=
<92638966+TC-MO@users.noreply.github.com>
Date: Wed, 3 Dec 2025 23:32:12 +0100
Subject: [PATCH 1/3] docs: remove glossary
remove glossary directory
remove glossary from sidebar and 2nd navbar
remove mentions of glossary from AGENTS.md
---
AGENTS.md | 1 -
docusaurus.config.js | 5 --
.../glossary/concepts/css_selectors.md | 66 -----------------
.../glossary/concepts/dynamic_pages.md | 39 ----------
.../glossary/concepts/html_elements.md | 40 -----------
.../academy/glossary/concepts/http_cookies.md | 20 ------
.../academy/glossary/concepts/http_headers.md | 48 -------------
sources/academy/glossary/concepts/index.md | 17 -----
.../concepts/querying_css_selectors.md | 37 ----------
.../concepts/robot_process_automation.md | 42 -----------
sources/academy/glossary/glossary.md | 15 ----
sources/academy/glossary/tools/apify_cli.md | 46 ------------
.../glossary/tools/edit_this_cookie.md | 48 -------------
.../tools/images/edit-this-cookie-options.png | Bin 67522 -> 0 bytes
.../tools/images/edit-this-cookie-popup.png | Bin 69009 -> 0 bytes
.../tools/images/insomnia-cookies.png | Bin 12027 -> 0 bytes
.../tools/images/insomnia-interface.jpg | Bin 120308 -> 0 bytes
.../tools/images/insomnia-manage-cookies.jpg | Bin 115747 -> 0 bytes
.../glossary/tools/images/insomnia-proxy.png | Bin 25674 -> 0 bytes
.../tools/images/insomnia-timeline.jpg | Bin 120500 -> 0 bytes
.../academy/glossary/tools/images/js-off.png | Bin 9921 -> 0 bytes
.../academy/glossary/tools/images/js-on.png | Bin 9216 -> 0 bytes
.../glossary/tools/images/modheader.jpg | Bin 76840 -> 0 bytes
.../tools/images/postman-cookies-button.png | Bin 12862 -> 0 bytes
.../tools/images/postman-interface.png | Bin 156110 -> 0 bytes
.../tools/images/postman-manage-cookies.png | Bin 40627 -> 0 bytes
.../glossary/tools/images/postman-proxy.png | Bin 53176 -> 0 bytes
.../tools/images/proxyman-apps-tab.png | Bin 25545 -> 0 bytes
.../glossary/tools/images/proxyman-filter.png | Bin 45188 -> 0 bytes
.../tools/images/proxyman-results.jpg | Bin 160065 -> 0 bytes
.../tools/images/proxyman-view-request.jpg | Bin 160514 -> 0 bytes
.../tools/images/settings-integrations.jpg | Bin 141004 -> 0 bytes
.../tools/images/switchyomega-auth.png | Bin 13464 -> 0 bytes
.../tools/images/switchyomega-menu.png | Bin 22834 -> 0 bytes
.../tools/images/switchyomega-options.png | Bin 90521 -> 0 bytes
.../images/switchyomega-proxy-profile.png | Bin 72914 -> 0 bytes
.../images/switchyomega-proxy-settings.png | Bin 13697 -> 0 bytes
.../glossary/tools/images/switchyomega.png | Bin 52177 -> 0 bytes
.../images/user-agent-switcher-agents.png | Bin 13245 -> 0 bytes
.../images/user-agent-switcher-config.png | Bin 91382 -> 0 bytes
.../images/user-agent-switcher-groups.png | Bin 53910 -> 0 bytes
sources/academy/glossary/tools/index.md | 15 ----
sources/academy/glossary/tools/insomnia.md | 67 ------------------
sources/academy/glossary/tools/modheader.md | 26 -------
sources/academy/glossary/tools/postman.md | 64 -----------------
sources/academy/glossary/tools/proxyman.md | 48 -------------
.../tools/quick_javascript_switcher.md | 18 -----
.../academy/glossary/tools/switchyomega.md | 49 -------------
.../glossary/tools/user_agent_switcher.md | 26 -------
.../platform/deploying_your_code/deploying.md | 2 +-
.../expert_scraping_with_apify/index.md | 2 +-
.../platform/getting_started/apify_api.md | 4 +-
sources/academy/sidebars.js | 14 ----
.../node_js/choosing_the_right_scraper.md | 2 +-
.../webscraping/anti_scraping/index.md | 2 +-
.../anti_scraping/techniques/captchas.md | 2 +-
.../techniques/fingerprinting.md | 2 +-
.../anti_scraping/techniques/firewalls.md | 6 +-
.../anti_scraping/techniques/geolocation.md | 4 +-
.../cookies_headers_tokens.md | 2 +-
.../graphql_scraping/introspection.md | 4 +-
.../logging_into_a_website.md | 2 +-
.../webscraping/puppeteer_playwright/index.md | 2 +-
.../puppeteer_playwright/page/waiting.md | 6 +-
.../challenge/scraping_amazon.md | 2 +-
.../data_extraction/browser_devtools.md | 2 +-
.../data_extraction/using_devtools.md | 6 +-
67 files changed, 26 insertions(+), 777 deletions(-)
delete mode 100644 sources/academy/glossary/concepts/css_selectors.md
delete mode 100644 sources/academy/glossary/concepts/dynamic_pages.md
delete mode 100644 sources/academy/glossary/concepts/html_elements.md
delete mode 100644 sources/academy/glossary/concepts/http_cookies.md
delete mode 100644 sources/academy/glossary/concepts/http_headers.md
delete mode 100644 sources/academy/glossary/concepts/index.md
delete mode 100644 sources/academy/glossary/concepts/querying_css_selectors.md
delete mode 100644 sources/academy/glossary/concepts/robot_process_automation.md
delete mode 100644 sources/academy/glossary/glossary.md
delete mode 100644 sources/academy/glossary/tools/apify_cli.md
delete mode 100644 sources/academy/glossary/tools/edit_this_cookie.md
delete mode 100644 sources/academy/glossary/tools/images/edit-this-cookie-options.png
delete mode 100644 sources/academy/glossary/tools/images/edit-this-cookie-popup.png
delete mode 100644 sources/academy/glossary/tools/images/insomnia-cookies.png
delete mode 100644 sources/academy/glossary/tools/images/insomnia-interface.jpg
delete mode 100644 sources/academy/glossary/tools/images/insomnia-manage-cookies.jpg
delete mode 100644 sources/academy/glossary/tools/images/insomnia-proxy.png
delete mode 100644 sources/academy/glossary/tools/images/insomnia-timeline.jpg
delete mode 100644 sources/academy/glossary/tools/images/js-off.png
delete mode 100644 sources/academy/glossary/tools/images/js-on.png
delete mode 100644 sources/academy/glossary/tools/images/modheader.jpg
delete mode 100644 sources/academy/glossary/tools/images/postman-cookies-button.png
delete mode 100644 sources/academy/glossary/tools/images/postman-interface.png
delete mode 100644 sources/academy/glossary/tools/images/postman-manage-cookies.png
delete mode 100644 sources/academy/glossary/tools/images/postman-proxy.png
delete mode 100644 sources/academy/glossary/tools/images/proxyman-apps-tab.png
delete mode 100644 sources/academy/glossary/tools/images/proxyman-filter.png
delete mode 100644 sources/academy/glossary/tools/images/proxyman-results.jpg
delete mode 100644 sources/academy/glossary/tools/images/proxyman-view-request.jpg
delete mode 100644 sources/academy/glossary/tools/images/settings-integrations.jpg
delete mode 100644 sources/academy/glossary/tools/images/switchyomega-auth.png
delete mode 100644 sources/academy/glossary/tools/images/switchyomega-menu.png
delete mode 100644 sources/academy/glossary/tools/images/switchyomega-options.png
delete mode 100644 sources/academy/glossary/tools/images/switchyomega-proxy-profile.png
delete mode 100644 sources/academy/glossary/tools/images/switchyomega-proxy-settings.png
delete mode 100644 sources/academy/glossary/tools/images/switchyomega.png
delete mode 100644 sources/academy/glossary/tools/images/user-agent-switcher-agents.png
delete mode 100644 sources/academy/glossary/tools/images/user-agent-switcher-config.png
delete mode 100644 sources/academy/glossary/tools/images/user-agent-switcher-groups.png
delete mode 100644 sources/academy/glossary/tools/index.md
delete mode 100644 sources/academy/glossary/tools/insomnia.md
delete mode 100644 sources/academy/glossary/tools/modheader.md
delete mode 100644 sources/academy/glossary/tools/postman.md
delete mode 100644 sources/academy/glossary/tools/proxyman.md
delete mode 100644 sources/academy/glossary/tools/quick_javascript_switcher.md
delete mode 100644 sources/academy/glossary/tools/switchyomega.md
delete mode 100644 sources/academy/glossary/tools/user_agent_switcher.md
diff --git a/AGENTS.md b/AGENTS.md
index 8938ad051e..c94898835a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -160,7 +160,6 @@ sources/
└── academy/ # Educational content
├── tutorials/ # Step-by-step guides
├── webscraping/ # Web scraping courses
- └── glossary/ # Terminology and definitions
```
## Quality Standards
diff --git a/docusaurus.config.js b/docusaurus.config.js
index e0145425f8..072df84ebb 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -96,11 +96,6 @@ module.exports = {
to: `/academy/tutorials`,
activeBaseRegex: `${collectSlugs(join(__dirname, 'sources', 'academy', 'tutorials')).join('$|')}$`,
},
- {
- label: 'Glossary',
- to: `/academy/glossary`,
- activeBaseRegex: `${collectSlugs(join(__dirname, 'sources', 'academy', 'glossary')).join('$|')}$`,
- },
],
},
}),
diff --git a/sources/academy/glossary/concepts/css_selectors.md b/sources/academy/glossary/concepts/css_selectors.md
deleted file mode 100644
index ee36b53c0e..0000000000
--- a/sources/academy/glossary/concepts/css_selectors.md
+++ /dev/null
@@ -1,66 +0,0 @@
----
-title: CSS selectors
-description: Learn about CSS selectors. What they are, their types, why they are important for web scraping and how to use them in browser Console with JavaScript.
-sidebar_position: 8.4
-slug: /concepts/css-selectors
----
-
-CSS selectors are patterns used to select [HTML elements](./html_elements.md) on a web page. They are used in combination with CSS styles to change the appearance of web pages, and also in JavaScript to access and manipulate the elements on a web page.
-
-> Querying of CSS selectors with JavaScript is done using [query selector functions](./querying_css_selectors.md).
-
-## Common types of CSS selectors
-
-Some of the most common types of CSS selectors are:
-
-### Element selector
-
-This is used to select elements by their tag name. For example, to select all `` elements, you would use the `p` selector.
-
-```js
-const paragraphs = document.querySelectorAll('p');
-```
-
-### Class selector
-
-This is used to select elements by their class attribute. For example, to select all elements with the class of `highlight`, you would use the `.highlight` selector.
-
-```js
-const highlightedElements = document.querySelectorAll('.highlight');
-```
-
-### ID selector
-
-This is used to select an element by its `id` attribute. For example, to select an element with the id of `header`, you would use the `#header` selector.
-
-```js
-const header = document.querySelector(`#header`);
-```
-
-### Attribute selector
-
-This is used to select elements based on the value of an attribute. For example, to select all elements with the attribute `data-custom` whose value is `yes`, you would use the `[data-custom="yes"]` selector.
-
-```js
-const customElements = document.querySelectorAll('[data-custom="yes"]');
-```
-
-### Chaining selectors
-
-You can also chain multiple selectors together to select elements more precisely. For example, to select an element with the class `highlight` that is inside a `
` element, you would use the `p.highlight` selector.
-
-```js
-const highlightedParagraph = document.querySelectorAll('p.highlight');
-```
-
-## CSS selectors in web scraping
-
-CSS selectors are important for web scraping because they allow you to target specific elements on a web page and extract their data. When scraping a web page, you typically want to extract specific pieces of information from the page, such as text, images, or links. CSS selectors allow you to locate these elements on the page, so you can extract the data that you need.
-
-For example, if you wanted to scrape a list of all the titles of blog posts on a website, you could use a CSS selector to select all the elements that contain the title text. Once you have selected these elements, you can extract the text from them and use it for your scraping project.
-
-Additionally, when web scraping it is important to understand the structure of the website and CSS selectors can help you to navigate it. With them, you can select specific elements and their children, siblings, or parent elements. This allows you to extract data that is nested within other elements, or to navigate through the page structure to find the data you need.
-
-## Resources
-
-- Find all the available CSS selectors and their syntax on the [MDN CSS Selectors page](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors).
diff --git a/sources/academy/glossary/concepts/dynamic_pages.md b/sources/academy/glossary/concepts/dynamic_pages.md
deleted file mode 100644
index e85f1e9bed..0000000000
--- a/sources/academy/glossary/concepts/dynamic_pages.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-title: Dynamic pages and single-page applications
-description: Understand what makes a page dynamic, and how a page being dynamic might change your approach when writing a scraper for it.
-sidebar_position: 8.3
-slug: /concepts/dynamic-pages
----
-
-**Understand what makes a page dynamic, and how a page being dynamic might change your approach when writing a scraper for it.**
-
----
-
-Oftentimes, web pages load additional information dynamically, long after their main body is loaded in the browser. A subset of dynamic pages takes this approach further and loads all of its content dynamically. Such style of constructing websites is called Single-page applications (SPAs), and it's widespread thanks to some popular JavaScript libraries, such as [React](https://react.dev/) or [Vue](https://vuejs.org/).
-
-As you progress in your scraping journey, you'll quickly realize that different websites load their content and populate their pages with data in different ways. Some pages are rendered entirely on the server, some retrieve the data dynamically, and some use a combination of both those methods.
-
-## How page loading works {#about-page-loading}
-
-The process of loading a page involves three main events, each with a designated corresponding name:
-
-1. `DOMContentLoaded` - The initial HTML document is loaded, which contains the HTML as it was rendered on the website's server. It also includes all of the JavaScript which will be run in the next step.
-2. `load` - The page's JavaScript is executed.
-3. `networkidle` - Network [XHR/Fetch requests](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest) are sent and loaded, and data from these requests is populated onto the page. Many websites load essential data this way. These requests might be sent upon certain page events as well (not just the first load), such as scrolling or clicking.
-
-Now that we have a solid understanding of the different stages of page-loading, and the order they happen in, we can fully understand what a dynamic page is.
-
-## What is dynamic content {#what-is-dynamic-content}
-
-Dynamic content is any content that is rendered **after** the `DOMContentLoaded` event, which means any content loaded by JavaScript during the `load` event, or after any network XHR/Fetch requests have been made.
-
-Sometimes, it can be quite obvious when content is dynamically being rendered. For example, take a look at this gif:
-
-
-
-
-
-
-Here, it's very clear that new content is being generated. As we scroll down the Twitter feed, we can see the scroll bar jumping back up, signifying that more elements have been created using JavaScript.
-
-Other times, it's less obvious though. Content can appear to be static (non-dynamic) when it is not, or even sometimes the other way around.
diff --git a/sources/academy/glossary/concepts/html_elements.md b/sources/academy/glossary/concepts/html_elements.md
deleted file mode 100644
index d0c66e754a..0000000000
--- a/sources/academy/glossary/concepts/html_elements.md
+++ /dev/null
@@ -1,40 +0,0 @@
----
-title: HTML elements
-description: Learn about HTML elements. What they are, their types and how to work with them in a browser environment using JavaScript.
-sidebar_position: 8.6
-slug: /concepts/html-elements
----
-
-An HTML element is a building block of an HTML document. It is used to represent a piece of content on a web page, such as text, images, or videos. Each element is defined by a tag, which is a set of characters enclosed in angle brackets, such as `
`, `![]()
`, or `