Issue Details (XML | Word | Printable)

Key: JAVAEETUTORIAL-189
Type: New Feature New Feature
Status: Closed Closed
Resolution: Won't Fix
Priority: Minor Minor
Assignee: Ian Evans
Reporter: miss_duke
Votes: 0
Watchers: 1
Operations

If you were logged in you would be able to see more operations.
javaeetutorial

Use rich formatting with multi colors fonts and styles

Created: 13/Jun/13 02:30 AM   Updated: 26/Mar/14 05:48 PM   Resolved: 25/Mar/14 07:01 PM
Component/s: doc
Affects Version/s: 7.0.1
Fix Version/s: 7.0.4

Time Tracking:
Not Specified

Tags: format style readability
Participants: Ian Evans, Kim Haase and miss_duke


 Description  « Hide

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:
http://developer.android.com/guide/components/activities.html



Ian Evans added a comment - 24/Jun/13 04:40 PM

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


Ian Evans added a comment - 19/Sep/13 10:32 PM

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


Kim Haase added a comment - 25/Mar/14 07:01 PM

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


miss_duke added a comment - 26/Mar/14 08:17 AM

"...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)


Kim Haase added a comment - 26/Mar/14 05:48 PM

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.