[
https://issues.apache.org/jira/browse/FLINK-9806?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16563249#comment-16563249
]
Patrick Lucas commented on FLINK-9806:
--------------------------------------
I'm pleased with the impact of this so far: three test Google queries, "flink
metrics", "flink queryable state", and "flink flatmap", all have a link from
the stable docs as the first result.
However, DuckDuckGo, Bing, and Baidu still show terribly out of date results
for these queries, some even with the Flink 1.1.2 docs as the top result and no
"stable" URLs in sight.
Improving the experience on Google is still a good result.
> Add a canonical link element to documentation HTML
> --------------------------------------------------
>
> Key: FLINK-9806
> URL: https://issues.apache.org/jira/browse/FLINK-9806
> Project: Flink
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 1.5.0
> Reporter: Patrick Lucas
> Assignee: Patrick Lucas
> Priority: Major
> Labels: pull-request-available
> Fix For: 1.3.4, 1.4.3, 1.5.3, 1.6.0
>
>
> Flink has suffered for a while with non-optimal SEO for its documentation,
> meaning a web search for a topic covered in the documentation often produces
> results for many versions of Flink, even preferring older versions since
> those pages have been around for longer.
> Using a canonical link element (see references) may alleviate this by
> informing search engines about where to find the latest documentation (i.e.
> pages hosted under [https://ci.apache.org/projects/flink/flink-docs-master/).]
> I think this is at least worth experimenting with, and if it doesn't cause
> problems, even backporting it to the older release branches to eventually
> clean up the Flink docs' SEO and converge on advertising only the latest docs
> (unless a specific version is specified).
> References:
> * [https://moz.com/learn/seo/canonicalization]
> * [https://yoast.com/rel-canonical/]
> * [https://support.google.com/webmasters/answer/139066?hl=en]
> * [https://en.wikipedia.org/wiki/Canonical_link_element]
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
