[JAVAEETUTORIAL-189] Use rich formatting with multi colors fonts and styles Created: 13/Jun/13  Updated: 26/Mar/14  Resolved: 25/Mar/14

Status: Closed
Project: javaeetutorial
Component/s: doc
Affects Version/s: 7.0.1
Fix Version/s: 7.0.4

Type: New Feature Priority: Minor
Reporter: miss_duke Assignee: Ian Evans
Resolution: Won't Fix Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Tags: format, readability, style


Java tutorial now uses limited colors and fonts. For example Java code snippets in the tutorial remains in plain black.

Code snippets may be formatted as they are displayed in an IDE editor. Various colors fonts and styles may be used wherever possible in the tutorial text.

This needs some effort but this will tremendously increase the readability of the tutorial.

I can point Android tutorials as an example for good presentation:

Comment by Ian Evans [ 24/Jun/13 ]

We're working on finding a solution that will work with our tools. We'll update this issue as we make progress.

Comment by Ian Evans [ 19/Sep/13 ]

Lowering the priority and deferring to the next release. Our tools team does not have a solution for us at this time.

Comment by Kim Haase [ 25/Mar/14 ]

There is no plan for our tools to implement this feature. Colors used for syntactic purposes impede the accessibility of the documentation.

Comment by miss_duke [ 26/Mar/14 ]

"...Colors used for syntactic purposes impede the accessibility of the documentation..."

Colors used in Git, Android, AngularJS websites are all impede accessibility?! (If you have no resource or skill set please admit it, do not say stupid reasons)

Comment by Kim Haase [ 26/Mar/14 ]

1) Oracle focuses very strongly on accessibility issues, more than most companies.

2) Our tools team will not devote resources to features that might impede accessibility.

Generated at Tue Mar 28 18:40:12 UTC 2017 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.