You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@trafficserver.apache.org by "Igor Galić (Commented JIRA)" <ji...@apache.org> on 2011/11/17 09:16:51 UTC

[jira] [Commented] (TS-1026) Changes to improve docs formatting

    [ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13151897#comment-13151897 ] 

Igor Galić commented on TS-1026:
--------------------------------

Not quite sure this is the intended result.

Both, the TOC and the navigation now break in interesting ways: There's no longer any indentation to show structure.
The texts themselves are no longer justified and the definition lists, which we use exhaustively: http://trafficserver.staging.apache.org/docs/trunk/admin/configuration-files/records.config.en.html look skewed as well.

I don't think it would be good to commit this to show you how it looks - so I have to disagree with you: It does not fix the docs page formatting ;) I would go so far as to argue it breaks it!
                
> Changes to improve docs formatting
> ----------------------------------
>
>                 Key: TS-1026
>                 URL: https://issues.apache.org/jira/browse/TS-1026
>             Project: Traffic Server
>          Issue Type: Improvement
>          Components: Web site
>            Reporter: zoe slattery
>            Priority: Minor
>         Attachments: docspagethml.diff, indexhtml.diff, stylescss.diff
>
>
> Remove the 'banner' class in styles.css and make all heading formats the same. 
> Modify the docs template to use class blurbbox, this will leave margins around text.
> Still to do - fix the header of docs pages.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira