Bug 1045638

Summary:	v3 comprehensive install docs markup is buggy. page is barely readable in some sections
Product:	OKD	Reporter:	Dmitry S. Makovey <dmitry>
Component:	Documentation	Assignee:	mfisher
Status:	CLOSED WONTFIX	QA Contact:	mfisher
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	2.x
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-05-31 18:22:11 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:

Description Dmitry S. Makovey 2013-12-20 22:18:59 UTC

Description of problem:

Trying to get through the "node" section :
http://openshift.github.io/documentation-latest/oo_deployment_guide_comprehensive.html#the-node-host

I've encountered badly formatted sections which make it hard to read/comprehend. 

Version-Release number of selected component (if applicable):


How reproducible:

always

Steps to Reproduce:
1. go to http://openshift.github.io/documentation-latest/oo_deployment_guide_comprehensive.html#the-node-host
2. read
3.

Actual results:

unreadable content

Expected results:

readable content

Additional info:

Comment 2 Dmitry S. Makovey 2014-01-03 22:02:23 UTC

I could've helped fix the source, but it seems like github only receives HTML-dump of the docs and not the sources? Where can I find AsciiDoc source files for the documentation? 

"node" section is broken quite badly. To the point of not being able to follow it as I can't quite figure out what is a markup for what. At least having access to source markup files could resolve immediate issues.

Comment 5 Eric Paris 2017-05-31 18:22:11 UTC

We apologize, however, we do not plan to address this report at this time. The majority of our active development is for the v3 version of OpenShift. If you would like for Red Hat to reconsider this decision, please reach out to your support representative. We are very sorry for any inconvenience this may cause.