elastic / elastic/docs

Automatic documentation builds didn't notice version changes

Open
#1,792 1 comment 0 reactions 0 assignees View on GitHub
bug defer versions
Dominant language
Ruby
Stars
265
Forks
347
Avg merge
3d 15h
Merged PRs (30d)
2

Description

Related to https://github.com/elastic/docs/issues/804

On the day of the 6.8.8 and 7.6.2 releases, I merged https://github.com/elastic/docs/pull/1778 which updates the version numbers for the documentation.

By my understanding, the purpose of listing the {version}.asciidoc in the sources section of our books https://github.com/elastic/docs/blob/9b9488223801dce7c340b1e47c7a5f8c2ed11062/conf.yaml#L316 was to cause those books to be rebuilt when the version changed.

However, the next two automatic documentation builds failed to notice the version changes. I ultimately had to force a rebuild of all versions (which takes longer on time-critical release days) to force the new versions to be picked up and shown in pages like these:
- https://www.elastic.co/guide/en/kibana/6.8/targz.html (still showed 6.8.7 instead of 6.8.8)
- https://www.elastic.co/guide/en/elasticsearch/reference/7.6/targz.html (still showed 7.6.1 instead of 7.6.2)

At the time of the problem, @nik9000 verified that http://master.docs-preview.app.elstc.co/guide/en/kibana/6.8/targz.html and https://github.com/elastic/built-docs/blob/master/raw/en/kibana/6.8/targz.html were also not showing the updated versions.

Is the detection of version changes not working in our automatic builds after all?

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.