Commit Graph

3627 Commits (6011b7c4c19b9bd45f3fe78634feee4cc5c9c499)

Author SHA1 Message Date
Anwesha Das 86e7cd57b7
Add Ansible community 8.0.0rc1 porting guide (#80873) 2 years ago
Anwesha Das 47539a19ea
Add Ansible community 7.6.0 porting guide (#80868) 2 years ago
Sandra McCann a551e8db80
eol 2.12 docs (#80850) 2 years ago
Matt Martz f4b2d4d4bb
Add pipx instructions to install guide (#80833) 2 years ago
Don Naro 10d91db003
[Docs] update node req table for 2.15 (#80823) 2 years ago
Brian Coca 19b85ff415
have docs explain why we import guard (#80569)
Co-authored-by: Matt Clay <matt@mystile.com>
Co-authored-by: Don Naro <dnaro@redhat.com>
2 years ago
Akira Yokochi be02813d25
fix yes/no to true/false in loop documents etc (#80591) 2 years ago
fberndtsson e4194112a0
Update inconsistency playbooks_checkmode (#80692) 2 years ago
Abhijeet Kasurde c7e3c91294
Missing space in docs (#80779)
* Missing space between $ and ansible command

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2 years ago
Jordan Borean 0a36cd910e
Removed testing support for Server 2012 and 2012 R2 (#80778) 2 years ago
Anwesha Das bf53a26deb
Add Ansible community 8.0.0b1 porting guide (#80807) 2 years ago
Sandra McCann 1ff5d2bf5c
update version switcher for 2.15 (#80556) 2 years ago
Felix Fontein 70e0b1f544
docsite build: upgrade sphinx-ansible-theme and antsibull-core (#80734) 2 years ago
Matt Clay 2cd1744be3
Use ansible.module_utils.common.text.converters (#80704)
Replace use of old `ansible.module_utils._text` and add a unit test to maintain backwards compatibility.
2 years ago
Abhijeet Kasurde be6f2f43b6
Wording change (#80664) 2 years ago
Anwesha Das dbd3bf27ec
Add Ansible community 8.0.0a3 porting guide (#80691) 2 years ago
Abhijeet Kasurde 058b722a54
Remove terminal viewing docs (#80655)
* ansible-doc command can not handle terminal plugins since they
  are not documentable and configurable. Removing documentation section
  to list them.

Fixes: #80140

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2 years ago
Anwesha Das 038ff8b3de
Add Ansible community 8.0.0a2 porting guide (#80643) 2 years ago
Anwesha Das 5f6e1b22a7
Add Ansible community 7.5.0 porting guide (#80642) 2 years ago
Sarah Lau-Kilo 68e270d4cc
Add note guidelines for additional distributions (#80389) 2 years ago
Tim Way 791510ccba
Vars Plugin Documentation Improvement (#80470) 2 years ago
Akira Yokochi f05abd4540
fix become yes/no to true/false (#80515) 2 years ago
Matt Clay 560d5b00d0
Remove docs references to obsolete test plugins (#80576) 2 years ago
JaroslavKlech 44794e3ebc
Update tools and programs page as per community feedback (#80493) 2 years ago
Sandra McCann c1d8130df5
redirect old vmware guide (#80553) 2 years ago
Matt Martz 0ee7cfb128
Implement checks, and backwards compat change, to move forward with UTF-8 only (#80370)
Co-authored-by: Sandra McCann <samccann@redhat.com>
2 years ago
Anwesha Das d081ed3616
Adds Ansible 8 Porting Guide to Index Page (#80511) 2 years ago
Anwesha Das 362c949622
Add Ansible community 8.0.0a1 porting guide (#80498) 2 years ago
DopeforHope a7d6fdda66
Update ansible_tips_tricks.rst (#80477)
Fix quotation marks in example
2 years ago
Maxwell G 4e9d21ec32
installation_distros: update Fedora section (#80453) 2 years ago
Christinanik251 2ed4396558
Fix typo in playbooks_keywords.rst.j2 (#80461) 2 years ago
Christinanik251 5a44acc704
Update P() semantic markup example (#80464) 2 years ago
Sviatoslav Sydorenko a84b3a4e72
Fix misrendered sections in manpage generation
This change fixes bugs in the manpage generator that existed since it
was first added.

It exposes CLI `ARGUMENTS` value to manpage templates.

Before this change, the code contained a typo, causing the `for`-loop
iterate over individual characters of the `'ARGUMENTS'` string rather
than iterating over a tuple. A missing comma was at fault.

The updated code gets rid of the `for`-loop and conditionals since it
seems to have been a premature complexity increase and no other things
than `'ARGUMENTS'` were ever added into the broken iterable.

The functional change is that `arguments` is now always present in the
Jinja2 context, unlike being missing sometimes because of the previous
design (not that it was ever present, because of the bug! sigh...)

The Jinja2 templates perform an `{% if arguments %}` check, letting
the template engine silently ignore the missing variable. The clause
was always falsy, meaning that the arguments section was not included
in the manpages for at least the last 6 years. With this fix, it will
be.

This patch also deduplicates calling `opt_doc_list` @ generate_man.

It was called late in the execution, more times than necessary. This
patch makes sure it happens once by putting it at the top of the scope.

It fixes rendering library and inventory in manpages.

The corresponding Jinja2 templates have blocks wrapped with
conditionals like `{% if inventory %}` and `{% if library %}` but said
variables were never injected into the context, nor were they even
deduced on the Python side of the generator. This means that the
conditional clauses were always falsy, never showing the portions of
the manpages.

The Python script has hints for how the `inventory` variable was to be
calculated, which is confirmed through the Git paleontology efforts.

The block of code that references to the `inventory` bit was
incorrectly checking a variable with a list of nested objects for the
presence of a string which was never going to work.

This patch fixes this check by verifying the CLI flag against the
correct variable containing a list of options and exposes it to the
Jinja2 templates.
It also exposes the `library` variable in a similar way.

The block displaying other binaries in Sphinx CLI docs has been
synchronized with the manpage template.
Previously, the current binary was displayed also. This patch gets rid
of the unwanted trailing comma there too.

Finally, the CLI executables list in the manpage template now reuses
the same variable as the RST template that doesn't need any
post-processing in Jinja2.
Before, it was already used in the RST template so this patch aligns
both templates to use the same logic as they got out-of-sync over time.

PR #80450.
2 years ago
Yiannis af6d75e313
Add OpenSUSE to the distro's installation guide (#80308)
* Add OpenSUSE to the distro's installation guide

Similar to the rest of the distros, OpenSUSE distributes ansible and it was
missing.

Signed-off-by: ybonatakis <ybonatakis@suse.com>
2 years ago
Daniel-at-github ec403db1c7
Document how to run all tasks, even the ones with the never tag (#80315)
Co-authored-by: Martin Krizek <martin.krizek@gmail.com>
2 years ago
dzvision a6e0012b8a
Update playbooks_templating.rst (#80375) 2 years ago
WeiXinFam-Insta 0460f78081
Documentation changes for #80367 and #80270 (#80391) 2 years ago
Andrew Klychkov db8f1756bc
[Docs] communication.rst: Add a hint about adding Matrix shields to READMEs (#80392) 2 years ago
Sviatoslav Sydorenko 88a380c8f0
📝 Document macOS user deletion over SSH (#80358)
Co-authored-by: Matt Clay <matt@mystile.com>
Co-authored-by: Don Naro <dnaro@redhat.com>
2 years ago
Felix Fontein 4029da9a9f
Semantic markup docs (#80240)
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
Co-authored-by: Don Naro <dnaro@redhat.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
Co-authored-by: Matt Clay <matt@mystile.com>
2 years ago
Matt Davis 5e131a96c0
bump devel to 2.16.0.dev0 (#80390) 2 years ago
Sviatoslav Sydorenko a45dd2a01c
🐛📝 Undouble trailing colon @ `faq.rst` (#80359)
It is causing parsing/representation problems of the following
explicit RST code block.
2 years ago
Felix Fontein cf44c84396
Add antsibull-changelog and antsibull-docs to other tools and programs page. (#80340) 2 years ago
Matt Clay 0cfdf0ad59
Use a dedicated version helper for the docs build (#80345)
This removes the dependency on the release version helper in the docs-build sanity test.
2 years ago
Matt Clay 1d6f019ce6
Remove obsolete integration test aliases (#80342)
* Remove obsolete integration test aliases

* Remove obsolete `skip/osx` aliases

* Use `skip/macos` instead of `skip/osx` in docs
2 years ago
Anwesha Das 29e0a68af2
Add Ansible community 7.4.0 porting guide (#80338) 2 years ago
Achim fc9415eeb4
"Ansible Lint" IntelliJ plugin added (#80263) 2 years ago
Felix Fontein 4ea50cef23
validate-modules: check_mode attribute and compare with supports_check_mode parameter (#80090)
Co-authored-by: Brian Scholer <1260690+briantist@users.noreply.github.com>
2 years ago
Sandra McCann cba3952434
Move Collection requirements to ansible/ansible (#80234) 2 years ago
Benoît Geeraerts 1491ec8019
Update special_variables.rst (#80210)
The usage of a glossary on this page will allow linking to a specific special variable, like on the glossary page, e.g.: https://docs.ansible.com/ansible/latest/reference_appendices/glossary.html#term-Idempotency
2 years ago