You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@trafficserver.apache.org by "zoe slattery (Created) (JIRA)" <ji...@apache.org> on 2011/11/16 23:19:51 UTC
[jira] [Created] (TS-1026) Changes to improve docs formatting
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
[jira] [Updated] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Updated) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
zoe slattery updated TS-1026:
-----------------------------
Attachment: docspage.diff
stylescss.diff
indexhtml.diff
Worked on typography a bit and attached 3 diff files. What do you think?
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Commented) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13155031#comment-13155031 ]
zoe slattery commented on TS-1026:
----------------------------------
I wasn't happy with it either. I thought sans serif were accepted as generally easier to read - but can't remember where I read that, so possibly I remembered wrong. I just had a look at this http://www.smashingmagazine.com/2010/11/04/best-practices-of-combining-typefaces/, quite like the idea on combining serif text and sans serif header. WDYT?
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspagethml.diff, indexhtml.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Commented JIRA)" <ji...@apache.org>.
[ 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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Commented JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13158396#comment-13158396 ]
Igor Galić commented on TS-1026:
--------------------------------
wow! It looks great. Thank you very much.
I've committed your changes in r1207116
One thing I noticed is that we've neglected downloads.html :-S But other than that I'm very happy with what we've accomplished so far and will ask dev@ to greenlight the migration to live (and help out with the missing bits, should there be any)
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Commented) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13158456#comment-13158456 ]
zoe slattery commented on TS-1026:
----------------------------------
Thx - dont know why I always forget that. Looks just OK on my android phone - except downloads. I'll do a bit more fixing later tonight.
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Commented JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13155020#comment-13155020 ]
Igor Galić commented on TS-1026:
--------------------------------
I must say I'm quite happy with the changes. Although I think that our typography could use some tuning.
Fonts with Serifs seemed easier on the eye (in the long run), so I used those for the documentation pages.
Thoughts?
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspagethml.diff, indexhtml.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Commented) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13161595#comment-13161595 ]
zoe slattery commented on TS-1026:
----------------------------------
A bit later than I said - here is a fix for the downloads page. I made changes in both styles.css and downloads.html. You might need to check the links in downloads.html, I haven't changed anything but some of the links look a bit weird to me. For example, release 2.0.1 will download a file called ...2.0.0... I also thought the ordering was a bit odd, why does 2.0.1 seem to come in between 2.1.3 and 2.1.2? Anyway - didn't feel well informed enough to change content, so leaving it to you to do if it needs it.
This site does not look right on an IE emulator so I'm downloading Widows VM(s) to test on. Still need to tidy style sheets and odd files.
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Commented JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13158472#comment-13158472 ]
Igor Galić commented on TS-1026:
--------------------------------
Thanks a bunch! I'm really looking forward to it!
Btw, here's the thread for the migration: http://mail-archives.apache.org/mod_mbox/trafficserver-dev/201111.mbox/%3c7516ba6b-2a4f-4fc9-8832-b7aa4346e92b@iris%3e
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Commented) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13162498#comment-13162498 ]
zoe slattery commented on TS-1026:
----------------------------------
Thanks...
I just tested the site on IE7, IE8 and IE9. All look fine (although all I tested was the front page and docs).
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, downloadshtml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Commented) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13155043#comment-13155043 ]
zoe slattery commented on TS-1026:
----------------------------------
:-) After I wrote that I realised it was pretty much what you had before for the docs. I'll experiment with a few font families and submit another patch.
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspagethml.diff, indexhtml.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Commented JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13161626#comment-13161626 ]
Igor Galić commented on TS-1026:
--------------------------------
Thank you for the hint re broken links.
The reason for the odd ordering is that the releases are listed in the order they have been released.
2.0.x was the stable release branch
2.1.x was the development branch. The releases happened independently.
I'll try merging the old docs and the new ones so they will be available like so:
{noformat}
/docs/v2/<old docs>
/docs/3.0.x/<current docs>
/docs/3.2.x/<future docs>
etc..
{noformat}
I'll not touch the old docs (i.e.: The stuff currently available at http://trafficserver.apache.org/) content wise and don't plan on touching it *style* wise. I really want to be sure people notice that something's odd. when looking at *old* docs :)
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, downloadshtml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Commented JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13158449#comment-13158449 ]
Igor Galić commented on TS-1026:
--------------------------------
I'm all for deleting stuff we don't need.
You can find the staging site.. on staging:) http://trafficserver.staging.apache.org/
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Commented) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13151912#comment-13151912 ]
zoe slattery commented on TS-1026:
----------------------------------
Yes - fair point :-/ I was trying to merge styles.css and ts.css, mainly becaues styles.css has the stuff for resizing right on smaller screens and ts.css doesn't. I think we need the resizing to deal with overflowing headings. However - I have missed a lot of necessary stuff in ts.css, sorry. I'll redo it and attach another patch later on.
> 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
[jira] [Assigned] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Assigned JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Igor Galić reassigned TS-1026:
------------------------------
Assignee: Igor Galić
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspagethml.diff, indexhtml.diff, stylescss.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
[jira] [Issue Comment Edited] (TS-1026) Changes to improve docs
formatting
Posted by "Igor Galić (Issue Comment Edited JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13155013#comment-13155013 ]
Igor Galić edited comment on TS-1026 at 11/22/11 10:55 AM:
-----------------------------------------------------------
Does the {{docspagethml.diff}} stay the same, or is it not applied at all?
was (Author: i.galic):
Does the @docspagethml.diff@ stay the same, or is it not applied at all?
> 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: docspage.diff, docspagethml.diff, indexhtml.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Commented JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13155014#comment-13155014 ]
Igor Galić commented on TS-1026:
--------------------------------
Oh. Just.. igore me.
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspagethml.diff, indexhtml.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Commented JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13155013#comment-13155013 ]
Igor Galić commented on TS-1026:
--------------------------------
Does the @docspagethml.diff@ stay the same, or is it not applied at all?
> 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: docspage.diff, docspagethml.diff, indexhtml.diff, stylescss.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
[jira] [Updated] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Updated) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
zoe slattery updated TS-1026:
-----------------------------
Attachment: stylescss.diff
docspage.diff
Hi Igor - here is another try. I have not (so far) found any very nice way to fix the banner style headings. What I have done in this (if it works) is better but not perfect.
> 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: docspage.diff, docspagethml.diff, indexhtml.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "Igor Galić (Commented JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13155040#comment-13155040 ]
Igor Galić commented on TS-1026:
--------------------------------
+1
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspagethml.diff, indexhtml.diff, stylescss.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
[jira] [Updated] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Updated) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
zoe slattery updated TS-1026:
-----------------------------
Attachment: docspagethml.diff
indexhtml.diff
stylescss.diff
Fixes to docs page formatting
> 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
[jira] [Updated] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Updated) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
zoe slattery updated TS-1026:
-----------------------------
Attachment: stylescss.diff
downloadshtml.diff
Here are the diff files
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, downloadshtml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.diff, stylescss.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
[jira] [Commented] (TS-1026) Changes to improve docs formatting
Posted by "zoe slattery (Commented) (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/TS-1026?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13158445#comment-13158445 ]
zoe slattery commented on TS-1026:
----------------------------------
Thanks - just two other things - there is some tidying up to be done. The site isn't using (as far as I can tell) ts.css, ts-front.css, pygments_style.css or search.css. However - I left them alone (apart from copying a lot of ts.css into styles.css) because I didn't know what your plans were. They should be deleted if the site will never use them.
Also - I'd really like to test the site on a few other devices (phone, ipad) can I do that from a staged version? If so I guess I need a link?
> 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
> Assignee: Igor Galić
> Priority: Minor
> Attachments: docspage.diff, docspage.diff, docspagethml.diff, indexhtml.diff, indexhtml.diff, stylescss.diff, stylescss.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