From 7fd036c883269a48f191b150d34d54858f0001d2 Mon Sep 17 00:00:00 2001 From: nikcode9 <129772745+nikcode9@users.noreply.github.com> Date: Mon, 23 Oct 2023 17:11:20 +0530 Subject: [PATCH 01/13] Update README.rst --- README.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/README.rst b/README.rst index ce27ae7..012bbdc 100644 --- a/README.rst +++ b/README.rst @@ -32,9 +32,9 @@ Previously: Ansible 2.9 and earlier **Classic Ansible** * Single repository `ansible/ansible `_. -* Single package called `ansible` -* `ansible` had major releases twice a year -* New features go into the next major release - ie worst case you need to wait 6 months +* Single package called `ansible`. +* `ansible` had major releases twice a year. +* New features go into the next major release - ie worst case you need to wait 6 months. Now: Ansible 2.10 and later @@ -42,17 +42,17 @@ Now: Ansible 2.10 and later * The ``ansible/ansible`` (`ansible-base`) repository only contains: - * The core Ansible programs, ``ansible-{playbook,galaxy,doc,test,etc}`` - * Some documentation - * A tiny subset of modules and plugins to allow for a functioning controller - * Together this will be known as ``ansible-base`` + * The core Ansible programs, ``ansible-{playbook,galaxy,doc,test,etc}``. + * Some documentation. + * A tiny subset of modules and plugins to allow for a functioning controller. + * Together this will be known as ``ansible-base``. * The rest of the modules and plugins have been moved into various "collections" * Ansible Collections: * Can be released independently of ansible-base and Ansible, at whatever release cycle/cadence the collection maintainer prefers. - * Will have their own repo (GitHub, GitLab, etc) with dedicated backlog, ie no more shared massive issue & PR backlog - * Should still have CI testing and in many cases can be tested more thoroughly + * Will have their own repo (GitHub, GitLab, etc) with dedicated backlog, ie no more shared massive issue & PR backlog. + * Should still have CI testing and in many cases can be tested more thoroughly. * The released package of Ansible 2.10 will pull in ``ansible-base`` and the various community collections that were previously a part of ``ansible/ansible`` @@ -103,7 +103,7 @@ Although this document focuses on Community (upstream) content, there will be Pr Documentation ============== -* `Using Ansible Collections `_ +* `Using Ansible Collections `_. * `Developing Collections `_ * `Ansible Collections Requirements `_ From 5c315b628c6750bfce5ca927131243635a58aa29 Mon Sep 17 00:00:00 2001 From: nik <129772745+nikcode9@users.noreply.github.com> Date: Wed, 25 Oct 2023 15:23:22 +0530 Subject: [PATCH 02/13] Update README.rst --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 012bbdc..3dd90fb 100644 --- a/README.rst +++ b/README.rst @@ -168,7 +168,7 @@ Individual collections can be installed by doing: ``ansible-galaxy collection install NAMESPACE.COLLECTION`` -Q: What exactly is ansible-base for and what does it contain +Q: What exactly is ansible-base for and what does it contain? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ **Ansible-base** is the name of the code and package for what github.com/ansible/ansible has become now that most of the content has been removed. From 51efd3fa193f52fd381ad10e1baf0a4ddf88ad50 Mon Sep 17 00:00:00 2001 From: nik <129772745+nikcode9@users.noreply.github.com> Date: Wed, 25 Oct 2023 15:25:12 +0530 Subject: [PATCH 03/13] Update README.rst --- README.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.rst b/README.rst index 3dd90fb..be6f46b 100644 --- a/README.rst +++ b/README.rst @@ -104,8 +104,8 @@ Documentation ============== * `Using Ansible Collections `_. -* `Developing Collections `_ -* `Ansible Collections Requirements `_ +* `Developing Collections `_. +* `Ansible Collections Requirements `_. Work needed =========== @@ -136,7 +136,7 @@ Users of Ansible `Using Ansible Collections `_ -Q: Once the next version of Ansible is released, will my playbooks still work +Q: Once the next version of Ansible is released, will my playbooks still work? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ For users of the community version of ansible ``pip/apt-get install ansible`` will continue to give you a working install of Ansible including the three thousand plus modules that previously shipped with Ansible 2.9. @@ -243,7 +243,7 @@ The benefits of claiming content are the following: * Your own dedicated Issue and PR backlog * Ability to use more GitHub functionality, such as direct assignments, reviews, milestones and Project Boards -Q: What will versioning and deprecation look like for Collections +Q: What will versioning and deprecation look like for Collections? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ * In ansible/ansible: From e244b76d98ddc1ffbdfd3935cd3dd9c3164a9144 Mon Sep 17 00:00:00 2001 From: nik <129772745+nikcode9@users.noreply.github.com> Date: Thu, 26 Oct 2023 17:11:52 +0530 Subject: [PATCH 04/13] Update README.rst Co-authored-by: Maxwell G --- README.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.rst b/README.rst index be6f46b..c11f192 100644 --- a/README.rst +++ b/README.rst @@ -32,8 +32,8 @@ Previously: Ansible 2.9 and earlier **Classic Ansible** * Single repository `ansible/ansible `_. -* Single package called `ansible`. -* `ansible` had major releases twice a year. +* Single package called `ansible` +* `ansible` had major releases twice a year * New features go into the next major release - ie worst case you need to wait 6 months. From 7f7173a4e342cbc92659a132b22354aaf9c0e625 Mon Sep 17 00:00:00 2001 From: nik <129772745+nikcode9@users.noreply.github.com> Date: Thu, 26 Oct 2023 17:12:01 +0530 Subject: [PATCH 05/13] Update README.rst Co-authored-by: Maxwell G --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index c11f192..90ec628 100644 --- a/README.rst +++ b/README.rst @@ -31,7 +31,7 @@ Previously: Ansible 2.9 and earlier **Classic Ansible** -* Single repository `ansible/ansible `_. +* Single repository `ansible/ansible `_ * Single package called `ansible` * `ansible` had major releases twice a year * New features go into the next major release - ie worst case you need to wait 6 months. From 355ffcef907ff616955ce52cf1bc8a13e0a67a7d Mon Sep 17 00:00:00 2001 From: nik <129772745+nikcode9@users.noreply.github.com> Date: Thu, 26 Oct 2023 17:12:13 +0530 Subject: [PATCH 06/13] Update README.rst Co-authored-by: Maxwell G --- README.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.rst b/README.rst index 90ec628..e7365c2 100644 --- a/README.rst +++ b/README.rst @@ -42,9 +42,9 @@ Now: Ansible 2.10 and later * The ``ansible/ansible`` (`ansible-base`) repository only contains: - * The core Ansible programs, ``ansible-{playbook,galaxy,doc,test,etc}``. - * Some documentation. - * A tiny subset of modules and plugins to allow for a functioning controller. + * The core Ansible programs, ``ansible-{playbook,galaxy,doc,test,etc}`` + * Some documentation + * A tiny subset of modules and plugins to allow for a functioning controller * Together this will be known as ``ansible-base``. * The rest of the modules and plugins have been moved into various "collections" From b9704c7fdb9ee7b3ff9e4b9fc1ea7a8c6ce8e203 Mon Sep 17 00:00:00 2001 From: nik <129772745+nikcode9@users.noreply.github.com> Date: Thu, 26 Oct 2023 17:12:27 +0530 Subject: [PATCH 07/13] Update README.rst Co-authored-by: Maxwell G --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index e7365c2..6dddbb6 100644 --- a/README.rst +++ b/README.rst @@ -34,7 +34,7 @@ Previously: Ansible 2.9 and earlier * Single repository `ansible/ansible `_ * Single package called `ansible` * `ansible` had major releases twice a year -* New features go into the next major release - ie worst case you need to wait 6 months. +* New features go into the next major release - i.e., in the worst case, you need to wait 6 months. Now: Ansible 2.10 and later From 6ab720dcc8deb009607282321d42d1e28aabe5cd Mon Sep 17 00:00:00 2001 From: nik <129772745+nikcode9@users.noreply.github.com> Date: Thu, 26 Oct 2023 17:12:44 +0530 Subject: [PATCH 08/13] Update README.rst Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com> --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 6dddbb6..d7b9b2b 100644 --- a/README.rst +++ b/README.rst @@ -51,7 +51,7 @@ Now: Ansible 2.10 and later * Ansible Collections: * Can be released independently of ansible-base and Ansible, at whatever release cycle/cadence the collection maintainer prefers. - * Will have their own repo (GitHub, GitLab, etc) with dedicated backlog, ie no more shared massive issue & PR backlog. + * Will have their own repo (GitHub, GitLab, etc) with dedicated backlog, i.e. no more shared massive issue & PR backlog. * Should still have CI testing and in many cases can be tested more thoroughly. * The released package of Ansible 2.10 will pull in ``ansible-base`` and the various community collections that were previously a part of ``ansible/ansible`` From f2fce9e7dccd65f95dd981ca08daa05dbf6dc853 Mon Sep 17 00:00:00 2001 From: nik <129772745+nikcode9@users.noreply.github.com> Date: Thu, 26 Oct 2023 21:15:01 +0530 Subject: [PATCH 09/13] Update README.rst Co-authored-by: Maxwell G --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index d7b9b2b..b1100da 100644 --- a/README.rst +++ b/README.rst @@ -52,7 +52,7 @@ Now: Ansible 2.10 and later * Can be released independently of ansible-base and Ansible, at whatever release cycle/cadence the collection maintainer prefers. * Will have their own repo (GitHub, GitLab, etc) with dedicated backlog, i.e. no more shared massive issue & PR backlog. - * Should still have CI testing and in many cases can be tested more thoroughly. + * Should still have CI testing and in many cases can be tested more thoroughly * The released package of Ansible 2.10 will pull in ``ansible-base`` and the various community collections that were previously a part of ``ansible/ansible`` From 5504a64ddcb93e16a004983cfd9780ef029742ea Mon Sep 17 00:00:00 2001 From: nik <129772745+nikcode9@users.noreply.github.com> Date: Thu, 26 Oct 2023 21:15:11 +0530 Subject: [PATCH 10/13] Update README.rst Co-authored-by: Maxwell G --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index b1100da..4db7d1b 100644 --- a/README.rst +++ b/README.rst @@ -51,7 +51,7 @@ Now: Ansible 2.10 and later * Ansible Collections: * Can be released independently of ansible-base and Ansible, at whatever release cycle/cadence the collection maintainer prefers. - * Will have their own repo (GitHub, GitLab, etc) with dedicated backlog, i.e. no more shared massive issue & PR backlog. + * Will have their own repo (GitHub, GitLab, etc) with dedicated backlog, i.e. no more shared massive issue & PR backlog * Should still have CI testing and in many cases can be tested more thoroughly * The released package of Ansible 2.10 will pull in ``ansible-base`` and the various community collections that were previously a part of ``ansible/ansible`` From a92311160d7778b034aa3bee9c03734d10e60656 Mon Sep 17 00:00:00 2001 From: Maxwell G Date: Tue, 31 Oct 2023 02:36:38 +0000 Subject: [PATCH 11/13] README.rst: remove more unnecessary periods This is a simple bulleted list of nouns. We do not need full stops. --- README.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.rst b/README.rst index 4db7d1b..bae5f10 100644 --- a/README.rst +++ b/README.rst @@ -103,9 +103,9 @@ Although this document focuses on Community (upstream) content, there will be Pr Documentation ============== -* `Using Ansible Collections `_. -* `Developing Collections `_. -* `Ansible Collections Requirements `_. +* `Using Ansible Collections `_ +* `Developing Collections `_ +* `Ansible Collections Requirements `_ Work needed =========== From 2b7d3a008586f44c54b49013675c516603d3fc58 Mon Sep 17 00:00:00 2001 From: Maxwell G Date: Tue, 31 Oct 2023 02:37:29 +0000 Subject: [PATCH 12/13] README.rst: replace a hyphen with an em dash --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index bae5f10..dfb86c2 100644 --- a/README.rst +++ b/README.rst @@ -34,7 +34,7 @@ Previously: Ansible 2.9 and earlier * Single repository `ansible/ansible `_ * Single package called `ansible` * `ansible` had major releases twice a year -* New features go into the next major release - i.e., in the worst case, you need to wait 6 months. +* New features go into the next major release — i.e., in the worst case, you need to wait 6 months. Now: Ansible 2.10 and later From dfe422640239b68700434fbe1eb01b85cbac4350 Mon Sep 17 00:00:00 2001 From: Maxwell G Date: Tue, 31 Oct 2023 02:38:22 +0000 Subject: [PATCH 13/13] README.rst: spell out "and" instead of using an ampersand --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index dfb86c2..345eb89 100644 --- a/README.rst +++ b/README.rst @@ -51,7 +51,7 @@ Now: Ansible 2.10 and later * Ansible Collections: * Can be released independently of ansible-base and Ansible, at whatever release cycle/cadence the collection maintainer prefers. - * Will have their own repo (GitHub, GitLab, etc) with dedicated backlog, i.e. no more shared massive issue & PR backlog + * Will have their own repo (GitHub, GitLab, etc) with dedicated backlog, i.e. no more shared massive issue and PR backlog * Should still have CI testing and in many cases can be tested more thoroughly * The released package of Ansible 2.10 will pull in ``ansible-base`` and the various community collections that were previously a part of ``ansible/ansible``