mirror of
https://github.com/VictoriaMetrics/VictoriaMetrics.git
synced 2026-05-17 08:36:55 +03:00
e316ab878c
This commit moved all the docs/*.md files to docs/victoriametrics/ folder. This broke direct links to these files such as https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/docs/vmagent.md . Add the missing `/victoriametrics/` part here, so the link becomes https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/docs/victoriametrics/vmagent.md . The move of all the docs/*.md files into docs/victoriametrics/ folder is dubious because of the following reasons: - It breaks direct links to *.md files like mentioned above. It is impossible to fix such links all over the Internet, so they will remain broken :( The best thing we can do is to fix them on the resources we control such as VictoriaMetrics repository. - It breaks Google indexing of VictoriaMetrics docs. Google index contains old links such as https://docs.victoriametrics.com/vmagent/#features . Now such links are automatically redirected to https://docs.victoriametrics.com/victoriametrics/vmagent/#features by a javascript on the https://docs.victoriametrics.com/vmagent/ page. Google doesn't like redirects at javascript, since they are frequently used by black hat SEO purposes. This leads to pessimization of VictoriaMetrics docs in Google search result :( We cannot update the old links all over the Internet in order to avoid the redirect by javascript :( The best thing we can do is to add <meta rel="canonical"> header with the new location of the page at the old url, and hope Google won't remove VictoriaMetrics docs from its search results. @AndrewChubatiuk , please do this. - It breaks backwards navigation. When you click the https://docs.victoriametrics.com/vmagent/ link on some page and then press `back` button in the web browser, it won't return back you to the original page because of the intermediate redirect :( The broken navigation cannot be fixed for old links located all over the Internet. - It increases chances of breaking old links left on the Internet in the future, which will lead to 404 Not Found pages and angry users :( The sad thing is that we hit the same wall with harmful redirects again :( In the beginning the VictoriaMetrics docs links had .html suffix, and they were case-sensitive. For example, http://docs.victoriametrics.com/MetricsQL.html#rate . It has been decided for some unknown reason that it is a good idea to remove the .html suffix and to make all the links lowercase. So now such links are automatically redirected by javascript to https://docs.victoriametrics.com/metricsql/#rate and then redirected again by another javasript to https://docs.victoriametrics.com/victoriametrics/metricsql/#rate :( There are many old links all over the Internet (for example, at Reddit, StackOverflow, some internal Wiki pages, etc.). We cannot fix all of them, so we need to pray these links won't break in the future. @hagen1778, @tenmozes, @makasim , please make sure we won't hit the same wall in a third time. Updates https://github.com/VictoriaMetrics/VictoriaMetrics/pull/8595
235 B
235 B
See vmbackup docs here.
vmbackup docs can be edited at docs/vmbackup.md.