processing/p5.js

Add p5.strands examples on regular p5 functions that can be used in a strands context

Open

#8777 opened on May 10, 2026

View on GitHub
 (6 comments) (1 reaction) (1 assignee)JavaScript (20,784 stars) (3,178 forks)batch import
Area:WebGLDocumentationEnhancementHelp Wantedp5.js 2.0+

Description

Increasing access

This supports the effort of making strands more visible in the reference, and also makes it clearer what can and can't be used within p5.strands. For example, while we now support random(), it may not be clear from the random() reference page that it can be used in a shader. Having maybe one strands example for each of these would be helpful.

Most appropriate sub-area of p5.js?

  • Accessibility
  • Color
  • Core/Environment/Rendering
  • Data
  • DOM
  • Events
  • Image
  • IO
  • Math
  • Typography
  • Utilities
  • WebGL
  • Build process
  • Unit testing
  • Internationalization
  • Friendly errors
  • Other (specify if possible)

Feature enhancement details

We maybe want to put strands examples last, and have a bit of explanation above them saying that they can also be used in shaders. To interleave examples with explanation, examples must be written as inline example blocks: https://github.com/processing/p5.js/blob/dev-2.0/contributor_docs/contributing_to_the_p5js_reference.md#inserting-examples-within-the-description

Contributor guide

Tech stack
javascript
Domain
documentation
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
blocked
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
familiarity with p5.jsunderstanding of p5.strands and WebGL shadersknowledge of inline example format
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
55
Research direction
The issue is currently assigned, so first check if the assignee is actively working. If not, review the contributing guide at https://github.com/processing/p5.js/blob/dev 2.0/contributor docs/contributing to the p5js reference.md#inserting examples within the description to understand how to insert inline examples. Then identify p5 functions that are currently documented and can be used in strands, like random(), and add a strands example at the end of their reference page. The examples should demonstrate usage in a shader context with a brief explanation.