Skip to content

Versioned-docs: do not index old versioned docs#3486

Merged
snazy merged 1 commit intoapache:versioned-docsfrom
snazy:vc-exclude-search
Jan 23, 2026
Merged

Versioned-docs: do not index old versioned docs#3486
snazy merged 1 commit intoapache:versioned-docsfrom
snazy:vc-exclude-search

Conversation

@snazy
Copy link
Member

@snazy snazy commented Jan 20, 2026

Adds the front-matter tags robots: noindex (HTML META tag) and exclude_search: true (local site search) for old released versions, aka all except 1.3.0. The change was created using the script from #3485.

Adds the front-matter tags `robots: noindex` (HTML META tag) and `exclude_search: true` (local site search) for old released versions, aka all except 1.3.0. The change was created using the script from apache#3485.
## jq

Most Polaris Quickstart scripts require `jq`. Follow the instructions from the [jq](https://jqlang.org/download/) website to download this tool. No newline at end of file
Most Polaris Quickstart scripts require `jq`. Follow the instructions from the [jq](https://jqlang.org/download/) website to download this tool.
Copy link
Contributor

Choose a reason for hiding this comment

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

what's the change here? 🤔

Copy link
Contributor

Choose a reason for hiding this comment

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

possibly something to be fixed in the tool? 🤔

Copy link
Member Author

Choose a reason for hiding this comment

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

Newline

Copy link
Contributor

Choose a reason for hiding this comment

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

Indeed, a newline at the end of the file

@dimas-b
Copy link
Contributor

dimas-b commented Jan 20, 2026

@snazy : what is the rationale for not indexing old docs? thx!

@snazy
Copy link
Member Author

snazy commented Jan 20, 2026

Rationale is:
a) the search on the web site yields duplicate results
b) search engines (e.g. Google) or AI tools consider outdated information

@dimas-b
Copy link
Contributor

dimas-b commented Jan 20, 2026

From my POV the information is not necessarily duplicate / outdated as old docs are relevant to their respective project releases and the content can be different.

Although, I do not mind this change, I wonder what other people think about this 🤔

@snazy
Copy link
Member Author

snazy commented Jan 20, 2026

See #3039 and #3037 for context.

@github-project-automation github-project-automation bot moved this from PRs In Progress to Ready to merge in Basic Kanban Board Jan 23, 2026
@pingtimeout
Copy link
Contributor

I think for now, given the pace of Polaris and the fact that we are not supporting older releases, it makes sense to only let search engines index the most recent release only.

@dimas-b IMO, the risk of indexing old versions is that there will be more http links pointing to those versions than on the most recent ones. So people search for Polaris help would be redirected to old versions that are not necessary accurate anymore, missing either features or bugfixes. Wdyt?

Copy link
Contributor

@dimas-b dimas-b left a comment

Choose a reason for hiding this comment

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

Fair enough 👍

@snazy snazy merged commit eae54ad into apache:versioned-docs Jan 23, 2026
@github-project-automation github-project-automation bot moved this from Ready to merge to Done in Basic Kanban Board Jan 23, 2026
@snazy snazy deleted the vc-exclude-search branch January 23, 2026 16:04
snazy added a commit to snazy/polaris that referenced this pull request Jan 24, 2026
@snazy snazy mentioned this pull request Jan 24, 2026
snazy added a commit that referenced this pull request Jan 26, 2026
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.

3 participants

Comments