For the current public preview guides of AEP [1], we have received the following enhancement requests via email from Bob Kozdemba:

For the Getting Started Guide [2]:

"
In step 9, we're missing an important part of testing in the customer experience. The customer is likely going to want to test a web app from a browser, but in order to do that they will need to configure the router layer. That isn't documented here, but it is (confusingly) in the openshift docs. So, essentially what we need to do here is explain how to configure the router layer and test an application from a browser. We could (hopefully?) re-use the openshift docs via single sourcing (??)
"

For the Install Guide [3]:

"
- it's confusing to have a "getting started" guide and an "install guide". I think this is a common problem for us. Can we name these in such a way that it's obvious which one you start with? Or, should they be combined?

- Section 1.2.4. skydns - is this needed? Sounds like this could be removed

- Section 1.2.5 - Can this example be fleshed out to show how to take a docker image from a registry and deploy with AEP

- Section 1.2.6 - This is the router bit from Step 9 in the GS guide. It doesn't say here how to set up the router, which needs to come first (before defining a route)

The use case that we want to document start to finish here is getting a docker image, deploying it, and testing via a browser
"

From Vikram: These issues will require clarification and input from Bilhar (content strategist). I am adding a needinfo for Bilhar so we can work together to arrive at a particular use case. We will also need to leverage the OSE Guides.


[1] https://access.redhat.com/documentation/en/red-hat-atomic-enterprise-platform/
[2] https://access.redhat.com/documentation/en/red-hat-atomic-enterprise-platform/version-3.1/getting-started-guide/
[3] https://access.redhat.com/documentation/en/red-hat-atomic-enterprise-platform/version-3.1/installation-and-configuration-guide/