Daniel Keir Haywood created CAUSEWAY-3505:
---------------------------------------------

             Summary: 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
             Fix For: 2.0.0-RC3
         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