Commit Graph

3624 Commits (f4b2d4d4bb70d688d437ca79962d8d651b6e731c)

Author SHA1 Message Date
Matt Martz f4b2d4d4bb
Add pipx instructions to install guide (#80833) 1 year ago
Don Naro 10d91db003
[Docs] update node req table for 2.15 (#80823) 1 year 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>
1 year ago
Akira Yokochi be02813d25
fix yes/no to true/false in loop documents etc (#80591) 1 year ago
fberndtsson e4194112a0
Update inconsistency playbooks_checkmode (#80692) 1 year ago
Abhijeet Kasurde c7e3c91294
Missing space in docs (#80779)
* Missing space between $ and ansible command

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
1 year ago
Jordan Borean 0a36cd910e
Removed testing support for Server 2012 and 2012 R2 (#80778) 1 year ago
Anwesha Das bf53a26deb
Add Ansible community 8.0.0b1 porting guide (#80807) 1 year ago
Sandra McCann 1ff5d2bf5c
update version switcher for 2.15 (#80556) 1 year ago
Felix Fontein 70e0b1f544
docsite build: upgrade sphinx-ansible-theme and antsibull-core (#80734) 1 year 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.
1 year ago
Abhijeet Kasurde be6f2f43b6
Wording change (#80664) 1 year ago
Anwesha Das dbd3bf27ec
Add Ansible community 8.0.0a3 porting guide (#80691) 1 year 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>
1 year ago
Anwesha Das 038ff8b3de
Add Ansible community 8.0.0a2 porting guide (#80643) 1 year ago
Anwesha Das 5f6e1b22a7
Add Ansible community 7.5.0 porting guide (#80642) 1 year ago
Sarah Lau-Kilo 68e270d4cc
Add note guidelines for additional distributions (#80389) 1 year ago
Tim Way 791510ccba
Vars Plugin Documentation Improvement (#80470) 1 year ago
Akira Yokochi f05abd4540
fix become yes/no to true/false (#80515) 1 year ago
Matt Clay 560d5b00d0
Remove docs references to obsolete test plugins (#80576) 1 year ago
JaroslavKlech 44794e3ebc
Update tools and programs page as per community feedback (#80493) 1 year ago
Sandra McCann c1d8130df5
redirect old vmware guide (#80553) 1 year 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>
1 year ago
Anwesha Das d081ed3616
Adds Ansible 8 Porting Guide to Index Page (#80511) 1 year ago
Anwesha Das 362c949622
Add Ansible community 8.0.0a1 porting guide (#80498) 1 year ago
DopeforHope a7d6fdda66
Update ansible_tips_tricks.rst (#80477)
Fix quotation marks in example
1 year ago
Maxwell G 4e9d21ec32
installation_distros: update Fedora section (#80453) 1 year ago
Christinanik251 2ed4396558
Fix typo in playbooks_keywords.rst.j2 (#80461) 1 year ago
Christinanik251 5a44acc704
Update P() semantic markup example (#80464) 1 year 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.
1 year 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>
1 year 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>
1 year ago
dzvision a6e0012b8a
Update playbooks_templating.rst (#80375) 1 year ago
WeiXinFam-Insta 0460f78081
Documentation changes for #80367 and #80270 (#80391) 1 year ago
Andrew Klychkov db8f1756bc
[Docs] communication.rst: Add a hint about adding Matrix shields to READMEs (#80392) 1 year 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>
1 year 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>
1 year ago
Matt Davis 5e131a96c0
bump devel to 2.16.0.dev0 (#80390) 1 year ago
Sviatoslav Sydorenko a45dd2a01c
🐛📝 Undouble trailing colon @ `faq.rst` (#80359)
It is causing parsing/representation problems of the following
explicit RST code block.
1 year ago
Felix Fontein cf44c84396
Add antsibull-changelog and antsibull-docs to other tools and programs page. (#80340) 1 year 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.
1 year 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
1 year ago
Anwesha Das 29e0a68af2
Add Ansible community 7.4.0 porting guide (#80338) 1 year ago
Achim fc9415eeb4
"Ansible Lint" IntelliJ plugin added (#80263) 1 year 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>
1 year ago
Sandra McCann cba3952434
Move Collection requirements to ansible/ansible (#80234) 1 year 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
1 year ago
Esther Christopher 0937cc4862
Update connection.rst (#80194) 1 year ago
Alicia Cozine 507fd1bd60
Document debugging conditionals (#80239)
##### SUMMARY
Add a section to the docs describing how to debug conditional statements - how to get Ansible to show you whether your `when:` clause evaluates to `true` or `false`.

I ran into trouble with this and couldn't find anything in the docs. Thought I'd add it.


##### ISSUE TYPE
- Docs Pull Request

+label: docsite_pr
1 year ago
Matt Clay bad8843124
ansible-test - Update git diff handling (#80202)
This change allows ansible-test to work with newer versions of git on AZP.
1 year ago