mini notation reference table should mention chooseBy for random choice

[jwaldmann]

the table in https://tidalcycles.org/docs/reference/mini_notation
does not give an equivalent source-level function for "random choice" ([ .. | .. ]).

The implementation uses chooseBy https://github.com/tidalcycles/Tidal/blob/main/src/Sound/Tidal/ParseBP.hs#L120 , so it could be mentioned in the table. Cf. "randomly remove (?)" and `degradeBy.

I can make a PR, but want to ask for comments first. Perhaps it was a deliberate omission?

[jwaldmann]

Ah, now I see that's not choose(By) alone, because its type is choose :: [a] -> Pattern a, combining just values, while we want to combine patterns here. The implementation uses unwrap . segment 1 . choose (essentially)

So, perhaps add a reference to choose?

[jqueraltmo]

The example in the docs works the same as d1 $ segment 1 $ s (choose ["bd","cp","hh"]). I'll put this as equivalent if nobody says otherwise.