19 Commits (602f0598751360950d4bca7fb89bc0edafda0bad)

Author	SHA1	Message	Date
Dag Wieers	7cf08e9986	Improve parameter required values and ref fix (#36680) ... This PR includes: - An improvement to the parameter listing, where instead of yes/no, it is indicated with required/optional (easier when scrolling through a long list of parameters) - Ensure that module reference, eg. M(foobar) do not include the module document title	7 years ago
Dag Wieers	8a040415f9	Fix module references in module docs (#36674)	7 years ago
Dag Wieers	ba370b178d	docsite: Add 'Edit on GitHub' for module docs (#36667) ... This is something I always wanted, a 'Edit on GitHub' button for module documentation. I also removed the additional statement in the footer with instructions on how to edit the module documentation. PS The links go directly into the GitHub file editor now !	7 years ago
Brian Coca	bbd6b8bb42	Temporary (#31677) ... * allow shells to have per host options, remote_tmp added language to shell removed module lang setting from general as plugins have it now use get to avoid bad powershell plugin more resilient tmp discovery, fall back to `pwd` add shell to docs fixed options for when frags are only options added shell set ops in t_e and fixed option frags normalize tmp dir usag4e - pass tmpdir/tmp/temp options as env var to commands, making it default for tempfile - adjusted ansiballz tmpdir - default local tempfile usage to the configured local tmp - set env temp in action add options to powershell shift temporary to internal envvar/params ensure tempdir is set if we pass var ensure basic and url use expected tempdir ensure localhost uses local tmp give /var/tmp priority, less perms issues more consistent tempfile mgmt for ansiballz made async_dir configurable better action handling, allow for finally rm tmp fixed tmp issue and no more tempdir in ballz hostvarize world readable and admin users always set shell tempdir added comment to discourage use of exception/flow control * Mostly revert expand_user as it's not quite working. This was an additional feature anyhow. Kept the use of pwd as a fallback but moved it to a second ssh connection. This is not optimal but getting that to work in a single ssh connection was part of the problem holding this up. (cherry picked from commit 395b714120522f15e4c90a346f5e8e8d79213aca) * fixed script and other action plugins ensure tmpdir deletion allow for connections that don't support new options (legacy, 3rd party) fixed tests	7 years ago
scottb	f8f34c7bab	Moved generated module RSTs to their own directory. (#33966) ... * Moved generated module RSTs to their own directory. * WIP commit - fixed conflict with conf.py exclude_patterns by renaming module RST output directory to 'module_docs'. * Added new directory to formatter module links; aded new module directory to makefile clean. * Removed illegal comment from block.	7 years ago
Toshio Kuratomi	e07cbb033f	Keywords docs (#32807) ... * Fixup keyword dumping * Clarify introductory text * Turn links in the keyword description into seealso entries in the rst. * Have plugin_formatter cleanup trailing whitespace The indent filter in jinja2 < 2.10 indents blank lines by default which leads to trailing whitespace. Cleanup after that filter. * Edits * Copy edit	7 years ago
Brian Coca	2ed46e04f4	more updates to plugin/config generation (#30787) ... * fixed module generation added missing lookup page point to plugins when plugins made modules singular add display for verbose an debug messages nicer templating, changed generation order for ref corrected links moved most of lookup docs to plugin section * Copy edits * Fixed typos * Clarified wording	7 years ago
Brian Coca	8d56064ce4	fixed typo in if, restore module docs	7 years ago
Brian Coca	b233f3f296	updated plugin docs (#30490) ... * updated docs - for devs: - added inventory/vars section - made some updates to general section and other plugin types - for users: - added 'user' plugin section to start describing the plugins - docs on types, what they are and how to use - removed ref to deleted AUTHORS file - corrected several typos/headers - added descriptions to config.rst template - ignore generated files for cli/plugins and config - remove new generated files on `make clean` - moved details from devguid and intro doc to plugin specific pages - pretied up lookup notes - changed precedence ref to not conflict config - removed duplicate config data, as config is autogenerated and up to date - put new plugins under playbooks - added `pass` cause rst/python dislikes fractions - removed dupe in .gitignore, alpha sorted to avoid moar dupes - added try cause rst/python freaks out * generate plugins into their own dir only do plugins that support docs use toctree from main plugins page	7 years ago
jborean93	0e22afef52	fix for make webdocs	7 years ago
Adrian Likins	da15cf1f54	Generate plugin rst (#28901) ... Generate rst docs for plugins Based on rst generated for modules. But generated plugin docs go into docs/docsite/rst/plugins/$PLUGIN_TYPE/plugin_name.rst ( docs/docsite/rst/plugins/connection/ssh.py for ex) * move plugins docs to rst/*_plugins/ subdirs for namespace * Only gen support pages for modules for now. * Add generated plugin docs to gitignore* add list_*_plugins templates * support MODULES/PLUGINS filters for make htmldocs Add a 'PLUGINS=ssh' filter env var like MODULES to filter plugins to build docs for. * fixup 'historical' version_added, skip plugins/loader.py * Fix plugins_by_support ref link to new plugins/*/ location * use :ref: for common_return_values, allow empty version_added * warnings on missing doc info * add a prefix to _random_choice It was colliding with the target for random_choice plugin	7 years ago
Toshio Kuratomi	40ea448c7b	Misc docs fixes ... * Revise and link inline to the lists of modules * Fix jinja2 objects.inv fallback path * Fix bolding of deprecation marker * Change module_support to link to lists via :doc: That links to the top of the page instead of a section. * Add a short text for each list of maintained modules * Change maintenance info to only display on core and network modules	7 years ago
Adrian Likins	2941e86671	Fix plugin_formatter.py -l / MODULES=none make webdocs ... Fix the get_module_info check against the limit_to_modules list so building a subset/none of the module docs works again.	7 years ago
Toshio Kuratomi	546187a8af	Revamp the plugin_formatter doc generator ... * Use a template to generate the category lists * Refactor so that we first extract all of the data that we need to build the docs and then give that data to the templates to build with * Add docs page listing modules ordered by support level	7 years ago
Toshio Kuratomi	af2073d057	metadata 1.1 ... * Add network value to support_by field. * New support_by value, certified * Deprecate curated in favor of certified * Add conversion from 1.0 to 1.1 to metadata-tool * Add supported by Red Hat field to ansible-doc output	7 years ago
Branko Majic	f78baa1300	Implement ability to limit module documentation building (#24576) ... * Implement ability to limit module documentation building: - Added new option to plugin_formatter.py to support passing-in a list of modules for which the documentation should be built. - Updated docuemtnation Makefile to allow specifying list of modules via environment variables (defaulting to all modules). - Update instructions for building documentation and module development to include commands and description of limiting module documentation builds. * Updated implementation for limiting module documentation building: - Pass list of modules (or None) to list_modules function instead of string. - Move conversion of module list to argument parsing code. - No special keywords. Default ("") means build all modules. For no modules just specify non-existing module name. - Updated documentation to reflect the changes. * Updated implementation for limiting module documentation building: - Use better default value, and don't treat "" as special case. - Conditionally invoke different variants of command in Makefile instead of using special value "". * Minor edits Wording tweak	7 years ago
Dag Wieers	47738eb1dd	docs: PEP8 compliance (#24681) ... - Make PEP8 compliant	8 years ago
Matt Martz	eb5e906014	Support py3 in plugin_formatter.py (#24384) ... * Support py3 in plugin_formatter.py * Do everything in bytes	8 years ago
Brian Coca	424e1946f4	moved docs generation and templates to docs/	8 years ago