[
http://jira.magnolia-cms.com/browse/DOCUM-37?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Antti Hietala updated DOCUM-37:
-------------------------------
Description:
*(this issue is currently being edited, don't consider the following as actual
requirements)*
We'd like to gather some ideas, thoughts and feedback on the current
documentation site layout, and propose a few improvements, and/or a completely
new design.
The points below might not all directly be related to actual design. Some might
be solved by implementing/fixing features in the wiki rendering module, for
example. We'll reference to other Jira issues when appropriate.
h3. Current "issues" with the current layout
* Feels "outdated"; not very "fresh" or "modern".
* Syntax highlighting support for JSP and "no-highlight" needed for code blocks.
h3. Things we like about the current layout
* Clean and simple
* Common fonts that are clean and readable.
* Presentation is not cluttered by unnecessary color or imagery.
* Font sizes don't display correctly on iPhone. DOCU-151
h3. Further ideas or requirements
* Examples (which may or may not contain code samples) could be differentiated
from the rest with background color.
* Icons: we currently use a couple of icons in content - would be great if they
were consolidated:
** external links
(!http://documentation.magnolia-cms.com/dms/layout/external-link-ltr-icon.png!)
** (!), (on), ...
h3. Examples of documentation sites we like
* jQuery - http://api.jquery.com/jQuery.ajax/
* Sitepoint CSS reference - http://reference.sitepoint.com/css/syntax
* Google APIs -
http://code.google.com/apis/analytics/docs/tracking/asyncTracking.html
** Lots of white space. Easy on the eye.
** Reasonable fonts and heading sizes. Base font: Arial, Helvetica, sans-serif.
Heading 1 170%, Heading 2 130%
** Max 3 levels of headings in one article
was:
*(this issue is currently being edited, don't consider the following as actual
requirements)*
We'd like to gather some ideas, thoughts and feedback on the current
documentation site layout, and propose a few improvements, and/or a completely
new design.
The points below might not all directly be related to actual design. Some might
be solved by implementing/fixing features in the wiki rendering module, for
example. We'll reference to other Jira issues when appropriate.
h3. Current "issues" with the current layout
* Feels "outdated"; not very "fresh" or "modern".
h3. Things we like about the current layout
* Clean and simple
* Common fonts that are clean and readable.
* Presentation is not cluttered by unnecessary color or imagery.
h3. Further ideas or requirements
* Examples (which may or may not contain code samples) could be differentiated
from the rest with background color.
* Icons: we currently use a couple of icons in content - would be great if they
were consolidated:
** external links
(!http://documentation.magnolia-cms.com/dms/layout/external-link-ltr-icon.png!)
** (!), (on), ...
h3. Examples of documentation sites we like
* jQuery - http://api.jquery.com/jQuery.ajax/
* Sitepoint CSS reference - http://reference.sitepoint.com/css/syntax
* Google APIs -
http://code.google.com/apis/analytics/docs/tracking/asyncTracking.html
> Redesign of documentation.magnolia-cms.com
> ------------------------------------------
>
> Key: DOCUM-37
> URL: http://jira.magnolia-cms.com/browse/DOCUM-37
> Project: Documentation Module
> Issue Type: Task
> Components: templates
> Reporter: Grégory Joseph
> Assignee: Grégory Joseph
> Priority: Critical
> Fix For: 1.1
>
>
> *(this issue is currently being edited, don't consider the following as
> actual requirements)*
> We'd like to gather some ideas, thoughts and feedback on the current
> documentation site layout, and propose a few improvements, and/or a
> completely new design.
> The points below might not all directly be related to actual design. Some
> might be solved by implementing/fixing features in the wiki rendering module,
> for example. We'll reference to other Jira issues when appropriate.
> h3. Current "issues" with the current layout
> * Feels "outdated"; not very "fresh" or "modern".
> * Syntax highlighting support for JSP and "no-highlight" needed for code
> blocks.
> h3. Things we like about the current layout
> * Clean and simple
> * Common fonts that are clean and readable.
> * Presentation is not cluttered by unnecessary color or imagery.
> * Font sizes don't display correctly on iPhone. DOCU-151
> h3. Further ideas or requirements
> * Examples (which may or may not contain code samples) could be
> differentiated from the rest with background color.
> * Icons: we currently use a couple of icons in content - would be great if
> they were consolidated:
> ** external links
> (!http://documentation.magnolia-cms.com/dms/layout/external-link-ltr-icon.png!)
> ** (!), (on), ...
> h3. Examples of documentation sites we like
> * jQuery - http://api.jquery.com/jQuery.ajax/
> * Sitepoint CSS reference - http://reference.sitepoint.com/css/syntax
> * Google APIs -
> http://code.google.com/apis/analytics/docs/tracking/asyncTracking.html
> ** Lots of white space. Easy on the eye.
> ** Reasonable fonts and heading sizes. Base font: Arial, Helvetica,
> sans-serif. Heading 1 170%, Heading 2 130%
> ** Max 3 levels of headings in one article
>
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.magnolia-cms.com/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
----------------------------------------------------------------
For list details see
http://www.magnolia-cms.com/community/mailing-lists.html
To unsubscribe, E-mail to: <[email protected]>
----------------------------------------------------------------
