Comment 4 for bug 1289668

Revision history for this message
Meg McRoberts (dreidellhasa) wrote : Re: [Bug 1289668] Re: docs: pre install guide quick install is visually un-readable

Define "done" ;-) Seriously, this is happening as part of the new User's
Guide.
We have new screen shots with headers and commentary between them,
which solves this problem, but I have a bit more work to do before the guide
is ready for review. So I guess this is "In Progress" still, right? I
hope to have
a reviewable copy on gerrit by Monday.

I do have a bizarre formatting problem -- who is the expert on how sphinx
handles
images? What I have formats beautifully in PDF but, in HTML, all the
screen shots
play out on the left of the screen (crammed together vertically) while the
headers
and other prose are on the right. I think it has something to do with .png
files in
close proximity to each other. I put page breaks between the sections
(which left
just one image per page) and I thought it had solved the problem but it has
not.

I can't put the User's Guide up for you to see right now but we have the
same problem
in the Express Release Notes:
http://docs.mirantis.com/express/master/release-notes.html,
right at the top -- those are three separate little screen shots with
headers and text between
them. Any ideas?

meg

On Fri, May 9, 2014 at 3:40 AM, Mike Scherbakov
<email address hidden>wrote:

> Is it done or still in progress?
>
> --
> You received this bug notification because you are a bug assignee.
> https://bugs.launchpad.net/bugs/1289668
>
> Title:
> docs: pre install guide quick install is visually un-readable
>
> Status in Fuel: OpenStack installer that works:
> In Progress
>
> Bug description:
> docs: fuel-docs/pages/pre-install-guide/0060-quick-install-fuel.rst
>
> http://docs.mirantis.com/fuel/fuel-4.1/pre-install-guide.html#configuring-fuel-using-the-iso-image
>
> The text between the images makes no sense
> The text and images show no structure
> There appears to be no purpose or goal
> The images have no visual breaking between each other and the text
> related to each image
> The images are not scaled to the size of the page (might not be fixable)
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/fuel/+bug/1289668/+subscriptions
>