ソースを参照

[DOCS] Clarify backport policy for important technical corrections. (#49131)

* [DOCS] Clarify backport policy for important technical corrections.

* Update docs/README.asciidoc

Co-Authored-By: James Rodewig <james.rodewig@elastic.co>
debadair 5 年 前
コミット
054f37f99a
1 ファイル変更11 行追加12 行削除
  1. 11 12
      docs/README.asciidoc

+ 11 - 12
docs/README.asciidoc

@@ -5,20 +5,19 @@ See: https://github.com/elastic/docs
 
 === Backporting doc fixes
 
-* Doc bug fixes and enhancements to existing content should be made against master 
-and backported as far as the current version. Backporting doc changes to earlier minor versions
-that are out of maintenance is often complicated due to content restructuring and is not required.
-
-* Backport important fixes such as security updates that have a direct customer impact to all affected versions. 
-
-* Avoid backporting doc changes across major versions unless it’s an important fix or 
-the change is related to upgrading from the last minor version of the previous major.
-
+* Doc changes should generally be made against master and backported through to the current version
+  (as applicable).  
+  
+* Changes can also be backported to the maintenance version of the previous major version. 
+  This is typically reserved for technical corrections, as it can require resolving more complex
+  merge conflicts, fixing test failures, and figuring out where to apply the change.
+
+* Avoid backporting to out-of-maintenance versions. 
+  Docs follow the same policy as code and fixes are not ordinarily merged to
+  versions that are out of maintenance.
+  
 * Do not backport doc changes to https://www.elastic.co/support/eol[EOL versions]. 
 
-* Doc PRs opened against released (non-EOL) versions can be merged to that version, 
-applied to master, and backported to the current version (where applicable).  
-
 === Snippet testing
 
 Snippets marked with `[source,console]` are automatically annotated with