processing / processing/p5.js-web-editor
Add completion info previews to autocomplete suggestions
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 1.7k
- Forks
- 1.7k
- Avg merge
- 3d 4h
- Merged PRs (30d)
- 8
Description
Increasing Access
this feature would make the p5.js api more discoverable for beginners and learners by providing contextual documentation directly within the editor. users could quickly understand what a function does without needing to leave the editor and search the reference site, reducing context switching.
Feature request details
currently, autocomplete suggestions display function names and signatures, but provide little information about what the selected item actually does. users often need to open the p5.js reference in a separate tab to understand unfamiliar functions.
i propose adding completion info previews to autocomplete suggestions.
proposed workflow:
- start typing and autocomplete suggestions appear.
- navigate suggestions using the keyboard.
- when a suggestion is selected, pressing the right arrow key opens a documentation preview.
- esc closes the preview.
- or pressing enter opens the reference in new tab.
- tab or enter inserts the selected completion as usual.
why this approach
- encourages beginners to learn the api while writing code.
- reduces the need to switch between the editor and reference site.
- builds on existing keyboard navigation patterns.
- whole long documentation maybe intimidating for beginners.
design mockups:
additional notes
codemirror allows to show completion info through an "Info Pane" that displays extra details when a suggestion is selected.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
No implementation files or tests are named. Start by tracing the editor's CodeMirror autocomplete integration and reading how its Info Pane handles selected suggestions. Done means a selected completion opens a documentation preview with the proposed keyboard controls, Escape closes it, and Enter can open the reference in a new tab without breaking insertion.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- frontend
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100