Bug 1045638 - v3 comprehensive install docs markup is buggy. page is barely readable in some sections
Summary: v3 comprehensive install docs markup is buggy. page is barely readable in som...
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: OKD
Classification: Red Hat
Component: Documentation
Version: 2.x
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: mfisher
QA Contact: mfisher
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-12-20 22:18 UTC by Dmitry S. Makovey
Modified: 2017-05-31 18:22 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-05-31 18:22:11 UTC
Target Upstream Version:


Attachments (Terms of Use)

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.


Note You need to log in before you can comment on or make changes to this bug.