Skip to content

Commit a614f6e

Browse files
committed
grammar fixes suggested by nickmcintyre
1 parent b53b043 commit a614f6e

File tree

7 files changed

+57
-56
lines changed

7 files changed

+57
-56
lines changed

src/data/en.yml

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -358,19 +358,19 @@ learn:
358358
labeling-canvases-intro-3: functions in your code so your canvases are readible by screen readers and other assistive technology.
359359
labeling-canvases-what-is-labeling: What is screen reader labeling?
360360
labeling-canvases-what-is-labeling-1: >-
361-
The canvas HTML element compresses the visuals created by your p5 code into a bitmap. This
361+
The canvas HTML element compresses the visuals created by your p5 code into a bitmap (a rastered graphic composed of pixels). This
362362
bitmap on its own doesn't provide any significant meaning or description about its contents to
363363
screen readers. That’s why the p5.js <a class = "code" href="https://p5js.org/reference/#/p5/describe">describe()</a>,
364364
<a class = "code" href="https://p5js.org/reference/#/p5/describeElement">describeElement()</a>, <a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a>,
365365
and <a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a>
366-
functions exist-- these allow you to manually add screen reader-accessible descriptions to your
366+
functions exist these allow you to manually add screen reader-accessible descriptions to your
367367
code so that screen reader technologies can describe the canvas’ content in a meaningful way.
368368
labeling-canvases-what-is-labeling-2: >-
369369
Because a screen reader cannot naturally interpret the contents of a canvas bitmap, these functions
370370
add labels into your code that instruct the screen reader on how to describe certain elements
371371
within your canvas.
372372
labeling-canvases-what-is-labeling-3: >-
373-
For more further information about p5.js screen reader accessibility, please read
373+
For more information about p5.js screen reader accessibility, please read
374374
labeling-canvases-available-labels: Screen reader labels for p5.js
375375
labeling-canvases-available-labels-1: p5.js offers four different functions for labeling your canvas
376376
labeling-canvases-available-labels-li-1: >-
@@ -381,7 +381,7 @@ learn:
381381
This function's parameters include: <span class = "code">name</span>, which affords a string naming the element described; <span class = "code">text</span>, which affords a string of text as the label description;
382382
and <span class="code">display</span>, an optional parameter to set the visibility of the label.
383383
labeling-canvases-available-labels-li-3: >-
384-
<a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> generates a list providing a canvas description and its (visual) elements, including the canvas' size,
384+
<a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> generates a list providing a canvas description and its visual elements, including the canvas' size,
385385
canvas color, as well as each visual element’s color, position, and the amount of area the element covers within the canvas. This function's only parameter is <span class = "code">display</span>, which is an optional
386386
parameter to set the visibility of the label.
387387
labeling-canvases-available-labels-li-4: >-
@@ -426,10 +426,10 @@ learn:
426426
For canvases without any changing, moving, or interactive elements, you may use either the <a class = "code" href="https://p5js.org/reference/#/p5/describeElement">describeElement()</a>,
427427
<a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a>, or <a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a>
428428
functions to label the canvas’ visual content. However, keep in mind that <a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a> and <a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> generate their information based on
429-
the rudimentary code of the visual element, such as its size, color, and shape-- these functions won’t be able to interpret your
429+
the rudimentary code of the visual element, such as its size, color, and shape. These functions won’t be able to interpret your
430430
intention in using such a shape within a larger visual built using multiple shapes.
431431
labeling-canvases-best-practices-using-labels-simple-2: >-
432-
Keep in mind the context and objective of the canvas’ contents when choosing which function(s) to use: Is it better to describe the flower
432+
Keep in mind the context and objective of the canvas’ contents when choosing which function(s) to use. Is it better to describe the flower
433433
as eight circles and a rectangle, or as a flower with red petals and a green stem? What kind of labeling will provide the best
434434
description of your canvas?
435435
labeling-canvases-best-practices-using-labels-simple-3: >-
@@ -439,7 +439,7 @@ learn:
439439
labeling-canvases-best-practices-using-labels-interactive-1: >-
440440
If your canvas contains any animated elements or elements that change their visual form via user input (the click of a button, a
441441
dropdown selection, etc.), be sure that any descriptions of such elements update with their changes or animations. If you are using
442-
<a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> or <a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a> to describe the contents of your canvas, so long as these functions are placed within the draw() function, they
442+
<a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> or <a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a> to describe the contents of your canvas, so long as these functions are placed within the <a class = "code" href ="https://p5js.org/reference/#/p5/draw">draw()</a> function, they
443443
will automatically update with the shape’s new information. If you are using <a class = "code" href="https://p5js.org/reference/#/p5/describeElement">describeElement()</a>, use concatenation or another form of
444444
variable input to update the element’s description.
445445
labeling-canvases-best-practices-using-labels-interactive-2: >-
@@ -488,7 +488,7 @@ learn:
488488
labeling-canvases-testing-labels-3: >-
489489
In order to reduce redundancy, be sure to reset the display parameter to <span class="code">FALLBACK</span> once you’ve tested the output. With <span class="code">LABEL</span> active, screen readers will read the fallback text
490490
and the visible label text when focused on the canvas.
491-
labeling-canvases-note: Notice any errors or typos? Please let us know. If you would like to contribute to this tutorial, feel free to issue a pull request!
491+
labeling-canvases-note: Notice any errors or typos? Please let us know. If you would like to contribute to this tutorial, feel free to issue a <a href = "https://github.com/processing/p5.js-website">pull request</a>!
492492
using-local-server: 'How to set up a local server on Mac OSX, Windows, or Linux.'
493493
p5js-wiki-title: p5.js wiki
494494
p5js-wiki: Additonal documentation and tutorials contributed by the community

src/data/es.yml

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -370,19 +370,19 @@ learn:
370370
labeling-canvases-intro-3: functions in your code so your canvases are readible by screen readers and other assistive technology.
371371
labeling-canvases-what-is-labeling: What is screen reader labeling?
372372
labeling-canvases-what-is-labeling-1: >-
373-
The canvas HTML element compresses the visuals created by your p5 code into a bitmap. This
373+
The canvas HTML element compresses the visuals created by your p5 code into a bitmap (a rastered graphic composed of pixels). This
374374
bitmap on its own doesn't provide any significant meaning or description about its contents to
375375
screen readers. That’s why the p5.js <a class = "code" href="https://p5js.org/reference/#/p5/describe">describe()</a>,
376376
<a class = "code" href="https://p5js.org/reference/#/p5/describeElement">describeElement()</a>, <a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a>,
377377
and <a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a>
378-
functions exist-- these allow you to manually add screen reader-accessible descriptions to your
378+
functions exist these allow you to manually add screen reader-accessible descriptions to your
379379
code so that screen reader technologies can describe the canvas’ content in a meaningful way.
380380
labeling-canvases-what-is-labeling-2: >-
381381
Because a screen reader cannot naturally interpret the contents of a canvas bitmap, these functions
382382
add labels into your code that instruct the screen reader on how to describe certain elements
383383
within your canvas.
384384
labeling-canvases-what-is-labeling-3: >-
385-
For more further information about p5.js screen reader accessibility, please read
385+
For more information about p5.js screen reader accessibility, please read
386386
labeling-canvases-available-labels: Screen reader labels for p5.js
387387
labeling-canvases-available-labels-1: p5.js offers four different functions for labeling your canvas
388388
labeling-canvases-available-labels-li-1: >-
@@ -393,7 +393,7 @@ learn:
393393
This function's parameters include: <span class = "code">name</span>, which affords a string naming the element described; <span class = "code">text</span>, which affords a string of text as the label description;
394394
and <span class="code">display</span>, an optional parameter to set the visibility of the label.
395395
labeling-canvases-available-labels-li-3: >-
396-
<a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> generates a list providing a canvas description and its (visual) elements, including the canvas' size,
396+
<a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> generates a list providing a canvas description and its visual elements, including the canvas' size,
397397
canvas color, as well as each visual element’s color, position, and the amount of area the element covers within the canvas. This function's only parameter is <span class = "code">display</span>, which is an optional
398398
parameter to set the visibility of the label.
399399
labeling-canvases-available-labels-li-4: >-
@@ -437,11 +437,11 @@ learn:
437437
labeling-canvases-best-practices-using-labels-simple-1: >-
438438
For canvases without any changing, moving, or interactive elements, you may use either the <a class = "code" href="https://p5js.org/reference/#/p5/describeElement">describeElement()</a>,
439439
<a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a>, or <a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a>
440-
functions to label the canvas’ visual content. However, keep in mind that <a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a> and textOutput() generate their information based on
441-
the rudimentary code of the visual element, such as its size, color, and shape-- these functions won’t be able to interpret your
440+
functions to label the canvas’ visual content. However, keep in mind that <a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a> and <a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> generate their information based on
441+
the rudimentary code of the visual element, such as its size, color, and shape. These functions won’t be able to interpret your
442442
intention in using such a shape within a larger visual built using multiple shapes.
443443
labeling-canvases-best-practices-using-labels-simple-2: >-
444-
Keep in mind the context and objective of the canvas’ contents when choosing which function(s) to use: Is it better to describe the flower
444+
Keep in mind the context and objective of the canvas’ contents when choosing which function(s) to use. Is it better to describe the flower
445445
as eight circles and a rectangle, or as a flower with red petals and a green stem? What kind of labeling will provide the best
446446
description of your canvas?
447447
labeling-canvases-best-practices-using-labels-simple-3: >-
@@ -451,7 +451,7 @@ learn:
451451
labeling-canvases-best-practices-using-labels-interactive-1: >-
452452
If your canvas contains any animated elements or elements that change their visual form via user input (the click of a button, a
453453
dropdown selection, etc.), be sure that any descriptions of such elements update with their changes or animations. If you are using
454-
<a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> or <a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a> to describe the contents of your canvas, so long as these functions are placed within the draw() function, they
454+
<a class = "code" href="https://p5js.org/reference/#/p5/textOutput">textOutput()</a> or <a class = "code" href="https://p5js.org/reference/#/p5/gridOutput">gridOutput()</a> to describe the contents of your canvas, so long as these functions are placed within the <a class = "code" href ="https://p5js.org/reference/#/p5/draw">draw()</a> function, they
455455
will automatically update with the shape’s new information. If you are using <a class = "code" href="https://p5js.org/reference/#/p5/describeElement">describeElement()</a>, use concatenation or another form of
456456
variable input to update the element’s description.
457457
labeling-canvases-best-practices-using-labels-interactive-2: >-
@@ -500,7 +500,7 @@ learn:
500500
labeling-canvases-testing-labels-3: >-
501501
In order to reduce redundancy, be sure to reset the display parameter to <span class="code">FALLBACK</span> once you’ve tested the output. With <span class="code">LABEL</span> active, screen readers will read the fallback text
502502
and the visible label text when focused on the canvas.
503-
labeling-canvases-note: Notice any errors or typos? Please let us know. If you would like to contribute to this tutorial, feel free to issue a pull request!
503+
labeling-canvases-note: Notice any errors or typos? Please let us know. If you would like to contribute to this tutorial, feel free to issue a <a href = "https://github.com/processing/p5.js-website">pull request</a>!
504504
using-local-server-title: Usando un servidor local
505505
using-local-server: 'Cómo configurar un servidor local en Mac OS X, Windows o Linux.'
506506
p5js-wiki-title: p5.js wiki

0 commit comments

Comments
 (0)