Updating Scarpet docs for Auxiliary.md

docs/scarpet/api/Auxiliary.md

@@ -4,33 +4,48 @@ Collection of other methods that control smaller, yet still important aspects of
 
 ## Sounds
 
+Functions which allow to manipulate the player's auditory environment.
+
 ### `sound()`, `sound(name, pos, volume?, pitch?, mixer?)`
 
 Plays a specific sound `name`, at block or position `pos`, with optional `volume` and modified `pitch`, and under
 optional `mixer`. Default values for `volume`, `pitch` and `mixer` are `1.0`, `1.0`, and `master`. 
 Valid mixer options are `master`, `music`, `record`, `weather`, `block`, `hostile`,`neutral`, `player`, `ambient`
 and `voice`. `pos` can be either a block, triple of coords, or a list of thee numbers. Uses the same options as a
- corresponding `playsound` command.
+ corresponding `playsound` command. Note that modifying `pitch` also modifies the duration of the sound.
 
-Used with no arguments, return the list of available sound names.
+Used with no arguments, return the list of all available sound names.
 
 Throws `unknown_sound` if sound doesn't exist.
+<pre>
+//Plays the sound of a zombie breaking down a door, with 4x the volume and 1/4th the pitch
+//Turning down ambient music in sound settings will reduce the volume of this sound
+sound('entity.zombie.break_wooden_door', [x, y, z], 4, 0.25, 'ambient')
+</pre>
 
 ## Particles
 
+Functions which allow to send particles of various forms to the player. These allow to highlight zones for all players,
+including those with vanilla clients (unlike with `draw_shape` function which only works for players with carpet clients)
+
 ### `particle()`, `particle(name, pos, count?. spread?, speed?, player?)`
 
-Renders a cloud of particles `name` centered around `pos` position, by default `count` 10 of them, default `speed` 
-of 0, and to all players nearby, but these options can be changed via optional arguments. Follow vanilla `/particle` 
-command on details on those options. Valid particle names are 
-for example `'angry_villager', 'item diamond', 'block stone', 'dust 0.8 0.1 0.1 4'`.
+Renders a cloud of particles `name` centered around `pos` position, by default `count` 10 of them, default `spread` 0.5 blocks,
+default `speed` of 0, and to all players nearby, but these options can be changed via optional arguments. Follow vanilla
+`/particle` command on details on those options. Valid particle names are for example `'angry_villager', 'item diamond',
+'block stone', 'dust 0.8 0.1 0.1 4'`.
 
 Used with no arguments, return the list of available particle names. Note that some of the names do not correspond to a valid
 particle that can be fed to `particle(...)` function due to a fact that some particles need more configuration
 to be valid, like `dust`, `block` etc. Should be used as a reference only.
 
 Throws `unknown_particle` if particle doesn't exist.
 
+<pre>
+// Shows 40 angry villager particles centred on the player's feet, with a spread of 0.75 blocks and speed of 1
+particle('angry_villager', [x, y, z], 40, 0.75, 1)
+</pre>
+
 ### `particle_line(name, pos, pos2, density?, player?)`
 
 Renders a line of particles from point `pos` to `pos2` with supplied density (defaults to 1), which indicates how far