[ 
https://issues.apache.org/jira/browse/CAUSEWAY-3505?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Daniel Keir Haywood updated CAUSEWAY-3505:
------------------------------------------
    Fix Version/s:     (was: 2.2.0)

> The help page automatically created by docgen could be improved
> ---------------------------------------------------------------
>
>                 Key: CAUSEWAY-3505
>                 URL: https://issues.apache.org/jira/browse/CAUSEWAY-3505
>             Project: Causeway
>          Issue Type: Improvement
>          Components: Core
>    Affects Versions: 2.0.0-RC1
>            Reporter: Daniel Keir Haywood
>            Priority: Minor
>         Attachments: image-2023-06-27-06-54-52-226.png, 
> image-2023-06-27-06-55-42-984.png
>
>
> Observations:
>  * all the content is on one very long page called "Welcome".  I feel this is 
> too long.  Suggest:
>  ** one page for the menubars
>  ** a separate page for each object, as a "reference".
>  *** perhaps grouped as in a telephone directory, "A", "B", "C", ...
>  * de-emphasis the diagrams ... at the moment they are the first thing that 
> one clicks on, and they would be very technical to an end-user
>  ** 
>  *** perhaps provide a way to disable them globally
>  * the spacing in the welcome page is uneven
> Also
>  * there are some places where a bullet is shown within no text against it, 
> eg in the demo app:
> !image-2023-06-27-06-54-52-226.png|width=335,height=212!
>  
> and
>  
> !image-2023-06-27-06-55-42-984.png|width=459,height=259!



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to