diff --git a/bibliography.md b/bibliography.md index b2bca18..45edb85 100644 --- a/bibliography.md +++ b/bibliography.md @@ -9,3 +9,4 @@ - Hanlon, J. (2018). Stack Overflow Isn’t Very Welcoming. It’s Time for That to Change. [online] Stack Overflow Blog. Available at: https://stackoverflow.blog/2018/04/26/stack-overflow-isnt-very-welcoming-its-time-for-that-to-change/. - Fisher, M. (2013). Suffering With a Smile. [online] Available at: https://theoccupiedtimes.org/?p=11586 [Accessed 16 Feb. 2023]. - Norman Wilson, A. (2011). Workers Leaving the Googleplex. [online] Available at: http://www.andrewnormanwilson.com/WorkersGoogleplex.html +- GitHub. (2021). require `describe()` function in p5 sketches? · Issue #5427 · processing/p5.js. [online] Available at: https://github.com/processing/p5.js/issues/5427 [Accessed 10 Apr. 2023]. diff --git a/chapters/02_backdoors.md b/chapters/02_backdoors.md index 1a20721..e942891 100644 --- a/chapters/02_backdoors.md +++ b/chapters/02_backdoors.md @@ -159,13 +159,20 @@ Alt-text is an essential part of web accessibility. It has existed since the 199 The workbook of Cocklyat and Finnegan is a whole piece of code documentation dedicated to a single HTML attribute. It re-frames `alt` text as a type of poetry, and provides exercises to practice writing. Their intention is not just to allow alt-text users to be able to access visual content on the internet, but to let them feel a sense of belonging in the digital spaces. By highlighting the needs of often marginalized minorities, and giving them propper representation, documentation can activate ways of thinking that actively shape technical implementations, acknowledging both the needs of machines and programmers and users as well. -The `p5.js` library for example offers a `describe()` and `describeElement()` functions, to provide a description analogue to the `alt` text one for their visual sketches. The interactive graphics are based on the HTML `canvas` element, that instead of dealing with its contents in a semantic way as HTML does, works on pixel bases. Similar to images, these contents are not compatible with screen readers, and require a text explanation in order to render accessible what's happening on screen. Even more: while images are usually static, p5.js visuals are often in motion, and evolve through time. With `describeElement()`, developers can even be more granular in their descriptions, captioning transformations of different elements in their animations. +The `p5.js` library for example offers a `describe()` and `describeElement()` functions, to provide a description analogue to the `alt` text one for their visual sketches. The interactive graphics are based on the HTML `canvas` element, that instead of dealing with its contents in a semantic way as HTML does, works on pixel bases. Similar to images, these contents are not compatible with screen readers, and require a text explanation in order to render accessible what's happening on the display. Even more: while images are usually static, p5.js visuals are often in motion, and evolve through time. With `describeElement()`, developers can even be more granular in their descriptions, captioning transformations of different elements in their animations. + +In the discussions around the development of this open source project, contributors started considering how to encourage the usage of this function. From an initial suggestion of making it a requirement in order for sketch to run, opinions settled on conveying its importance from the documentation, by adding it to the default template, and to the examples in the documentation and tutorial. + +![p5.js interactive editor in the documentation, displaying the usage of the rect and describe functions](../img/p5js.png) +Examples from p5.js documentation. + + + -In the discussions on GitHub around the development of this open source project, contributors started considering how to encourage the usage of this function. From an initial suggestion of making it required in order to run the sketch, opinions settled on conveying its importance from the pages in the documentation, by adding it to the default in sketches templates, and to the examples in the documentation. - bc the concept of p5js is continuous iterations - documentation better surface to address the prob - +- open to contributions to address the issue (Actually, not happened yet. But there are pull requests with some of these integrations awaiting to be merged with the main branch.) `(ok rephrase it not to write pull request and merge)` diff --git a/img/p5js.png b/img/p5js.png new file mode 100755 index 0000000..11b3f64 Binary files /dev/null and b/img/p5js.png differ