In the PVector reference there's currently a passage that reads:

"A class to describe a two or three dimensional vector. This datatype stores two or three variables that are commonly used as a position, velocity, and/or acceleration."

I'm learning about vector maths and I found this confusing. The way this is currently worded, one could get the false impression (as i did) that a single PVector object commonly stores values corresponding to position, velocity and acceleration. In fact (If I've understood correctly) the correct meaning is that a single PVector object is commonly used to encode _either_ position, velocity or acceleration.

Here's my suggestion for an alternative description text that I think would be less likely to be misinterpreted. Please feel free to add corrections or point out errors in my understanding:

"A class to describe a two or three dimensional vector. Two dimensional PVector objects hold two values, three dimensional PVector objects hold three values. These values normally correspond to the x, y and z axes in a coordinate system.

A single PVector object typically gets used to describe position (coordinates for each dimension), velocity (the rate/direction in which the object’s position changes per time unit, for each dimension) or force (a strength and direction which exerts an influence on an object’s velocity over time).

Since vectors represent groupings of values, we cannot simply use traditional addition/multiplication/etc. Instead, we’ll need to do some "vector" math, which is made easy by the methods inside the PVector class."