improve & add documentation

[trentgill]

input[n].mode = 'clock' is undocumented

should appear here but there is no reference.

[trentgill]

from #464

• add documentation for changing ii address allow variable style control of ii address #441
• improve documentation for unique_id function [not sure what this means]

[trentgill]

other new features already in main:

• ii "high-reliability" mode add high-reliability mode for i2c #457
• sequins string mode Sequins strings + other goodies #446
• math.rand vs math.srand add seeded random option #442
• sequins current value inspect add method to peek at current value without changing it #436

[trentgill]

all the currently open PRs that are soon to be merged need docs added to the main page. most of them have extensive usage & examples in the PRs, but need to be distilled into documentation. it probably makes sense to capture them in some kind of blog-post style introduction -- perhaps linked to my website or a lil stub page on the monome site? unsure where that stuff should live.

• timeline new timeline module #447
• hotswap hotswap library #456
• qscale library Qscale library #452 [pushed to 4.1]

there is an additional PR about i2c reliability (#458) but something is already merged (#457). not sure what's going on there.

// EDIT

this is now included in main

• sequins transformers Sequins transformers #449

and testing should be based on the timeline PR noted here. @dndrks let me know if you have issues downloading the file or uploading the firmware!

• timeline new timeline module #447

download firmware: (you'll need to be logged into github to download. got to Pull Requests tab. Click on dev4.0, scroll to the bottom, find "All checks have passed" and click on "Show all checks" to the right. Then click "details" in the pop-down. Then click "Summary" in the top-left. Then at the centre-bottom click on the crow-#######.zip to download the firmware.)

@dndrks note the link above has changed as of 2/22 ~3pm EST so timeline should work correctly.

[dndrks]

raaaad, these are all amazing additions to an already-fantastic toolkit!!

re:

[...] perhaps linked to my website or a lil stub page on the monome site? unsure where that stuff should live.

i'd love to keep these on the monome site with the rest of the scripting docs, if you're okay with it? also totally happy to build supplemental materials and just to links out to your write-ups, but since folks will likely email [email protected] with clarifying q's over their ownership, it'd be nice to not have to task you with updates + addendums.

[trentgill]

Yeah i'd be totally happy for them to live on the monome docs site. Mostly just conscious that the conversational style isn't quite aligned with the rest of the docs. Very happy if you want to edit them into something a little more straightforward / with less assumptions :)

[trentgill]

Closing this as all the info is now in the monome docs. there's still more to do with editing / tidying up / re-organization, but the docs are now up-to-date with the 4.0 release, so let's start a new issue if there's specific issues that arise.