Docs: User guide overhaul, part 2 #65474
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
ansibot
added
affects_2.10
This comment has been minimized.
This comment has been minimized.
ansibot
added
needs_revision
|
The test |
ansibot
added
docsite
samccann
reviewed
Dec 4, 2019
ansibot
removed
the
needs_triage
|
@acozine This PR was evaluated as a potentially problematic PR for the following reasons:
Such PR can only be merged by human. Contact a Core team member to review this PR on IRC: |
ansibot
added
needs_rebase
acozine
force-pushed
the
user_guide_playbooks
branch
from
082dea4
to
9cf2230
Compare
ansibot
added
core_review
gundalow
reviewed
Dec 10, 2019
| Sample Ansible setup | ||
| ******************** | ||
|
|
||
| You have learned about playbooks, inventory, roles, and variables. This section pulls all those elements together, outlining a sample setup for automating a web service. You can find more example playbooks illustrating these patterns in our `ansible-examples repository <https://github.com/ansible/ansible-examples>`_. (NOTE: These may not use all of the features in the latest release, but are still an excellent reference!). |
There was a problem hiding this comment.
Assuming this is page zero, which pages are we assuming they've already read?
There was a problem hiding this comment.
I'm not entirely sure at this stage. The last step in the User Guide rewrite will be revamping all the various TOCs within it. I'd prefer to treat every page as Page Zero, because most users will come from search engine results, but also offer a reasonable "Zero to Sixty for Ansible Engine" tutorial if you follow the TOC.
Commit gundalow's review comments. Co-Authored-By: John R Barker <john@johnrbarker.com>
|
The test The test |
ansibot
added
ci_verified
ansibot
added
core_review
samccann
approved these changes
Dec 12, 2019
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
SUMMARY
Related to #63056.
Edits more User Guide pages. Main goals include reducing duplication of content, helping users find the content they need by providing action-oriented headers, and slimming down the text where possible.
Main changes include:
- Removes the old Best Practices pageISSUE TYPE
COMPONENT NAME
docs.ansible.com
user_guide