Code block aesthetics font and background

[Meg McRoberts]

Code blocks for docs written in RST have much shorter display lines than they did for the docbook files. I would recommend a smaller point size for the text in these blocks.

I find the black boxes a little glaring and they waste a lot of ink if I print the page. Perhaps they could be shaded with a lighter color?

[Chiawei Xie (dommgifer)]

Which page did you find about this question, could you show me link?

[Meg McRoberts (dreidellhasa)]

Hi there,Thanks for looking into this.
For one example, see http://docs.openstack.org/draft/ha-guide/controller-ha-haproxy.htmlThe docbook page is http://docs.openstack.org/high-availability-guide/content/ha-aa-haproxy.html

Here is the most egregious section I've had -- but it isn't appearing in the draft doc even though theCR has been merged.  So I took a snapshot from my local build -- see how the wget line in the firstblock is wrapped?  In the second block, I could add line feeds with \ and have a decent presentationbut I can't break a URL:

The same section rendered in docbook is at
http://docs.openstack.org/high-availability-guide/content/_add_block_storage_api_resource_to_pacemaker.html
While I was looking for these examples, I also noticed http://docs.openstack.org/draft/ha-guide/intro-ha-concepts.htmlSee the "System downtime" and "Data loss" list?  These are coded as a Definition list:
System downtime
    Occurs when a user-facing service is unavailable
    beyond a specified maximum amount of time.

Data loss
    Accidental deletion or destruction of data.

Thanks so much for looking at this!meg

      From: dommgifer <email address hidden>
 To: <email address hidden>
 Sent: Monday, July 13, 2015 12:54 AM
 Subject: [Bug 1470793] Re: Code block aesthetics font and background

Which page did you find about this question, could you show me link?

--
You received this bug notification because you are subscribed to the bug
report.
https://bugs.launchpad.net/bugs/1470793

Title:
  Code block aesthetics font and background

Status in openstack-manuals:
  New

Bug description:
  Code blocks for docs written in RST have much shorter display lines
  than they did for the docbook files.  I would recommend a smaller
  point size for the text in these blocks.

  I find the black boxes a little glaring and they waste a lot of ink if
  I print the page.  Perhaps they could be shaded with a lighter color?

To manage notifications about this bug go to:
https://bugs.launchpad.net/openstack-manuals/+bug/1470793/+subscriptions

[Meg McRoberts (dreidellhasa)]

We need to reduce the size of the font used in code blocks -- wget lines with long URLs cannot fit on one line unless the browser window is really wide and there are no good work-arounds. I agree that the pure aesthetic issues with code blocks are not high priority.