Skip to content

Commit 2495970

Browse files
committed
Add suggestions section
2 parents fa3d400 + aef6565 commit 2495970

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ This document describes the process for revising the p5.js examples for the 2023
99
- [Review & Analysis](#review--analysis)
1010
- [Editing Criteria](#editing-criteria)
1111
- [Organizational Structure](#organizational-structure)
12+
- [Suggestions for Content & Design](#suggestions-for-content--design)
1213
- [Preview](#preview)
1314

1415
## Review & Analysis
@@ -50,6 +51,16 @@ The examples directory in this repo contains a subdirectory for each category wi
5051

5152
Each category directory contains a 'More' subdirectory with additional examples related to that category. These are unedited and do not meet all out evaluation criteria. We recommend including them as an optionally revealed section for site visitors who want to explore further variety.
5253

54+
## Suggestions for Content & Design
55+
56+
We tried to avoid sketches that start animating without user interaction, as this goes against [WCAG 2.3.3](https://www.w3.org/WAI/WCAG21/Understanding/animation-from-interactions.html), and found some creative ways to do so. Some sketches do still start animating on load. We would suggest a button to completely stop the preview of the sketch, similar to the "run", "reset", and "copy" buttons currently used.
57+
58+
The git history on the examples has been maintained, and many files include contributions going back several years. If the page for each example listed all contributors for that file, this could be a great way to highlight the community collaborative nature of p5's development.
59+
60+
We would like to see the examples page communicate the progression from beginner to advanced to the visitor. Some introduction text at the top of the page would help, and there may be design choices that would help emphasize the progression.
61+
62+
We discussed the possibility of a future p5 Editor widget as a replacement for the current Ace editor. Before that is developed, we recommend adding a link/button to open the current example in the p5 Editor in a new tab. This will help visitors to remix examples and save them to their p5 Editor account.
63+
5364
## Preview
5465

5566
### Shapes & Color

0 commit comments

Comments
 (0)