Bug 1730886

Summary:	[DOCS] scaling router steps exist but are hard to find
Product:	OpenShift Container Platform	Reporter:	Steven Walter <stwalter>
Component:	Documentation	Assignee:	Jason Boxman <jboxman>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Xiaoli Tian <xtian>
Severity:	low	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	low
Version:	4.1.0	CC:	aos-bugs, jokerman, mmccomas
Target Milestone:	---
Target Release:	4.1.z
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2019-08-19 22:05:02 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Steven Walter 2019-07-17 19:38:59 UTC

Document URL: 
https://docs.openshift.com/container-platform/4.1/networking/ingress-operator.html

Section Number and Name: 
Scaling an Ingress controller

Describe the issue: 
The docs are technically correct and the steps dont need any changing. However, from a customer usability standpoint, a likely workflow would be:

1) "I need to scale up my routers!"
2) oc project openshift-ingress
3) I see my routers!
router-default-9d6f4ffc5-2nkg8   0/1     Running            0          38m
router-default-9d6f4ffc5-ljqcf   1/1     Running            0          56m
4) How do I scale?
5) Go to the docs
6) Search "router"
7) The doc for scaling the pods named "router" does not appear

Suggestions for improvement: 
Add the keyword "router" to the doc, or show an example output with the router pods

Additional information:

Comment 2 Jason Boxman 2019-08-01 01:16:20 UTC

I created an initial PR[0] for this.

[0] https://github.com/openshift/openshift-docs/pull/16087

Comment 3 Jason Boxman 2019-08-01 14:58:34 UTC

There's a preview of the change here:

https://bz-1730886--ocpdocs.netlify.com/openshift-enterprise/latest/networking/ingress-operator.html