I got confused at first with the new setup pages, since there are two now which look a bit similar but do different things. All tracks are linked by default at first - I tried to change this in the wrong page and thought it was brokenā¦
Is there a manual for Kria other than the information on the Ansible product page?
The āExtended parametersā explanation appears twice in the Kria description. Maybe where it appears the first time there should have actually been an explanation of how to setup and change (basic) functions and a copy/paste error occurred when inserting the text on the website?
Aha. That might have been a dodgy merge when the documentation was updated - Iām in part responsible for the updates to Ansible documentation.
The section on āLoop Syncā under āConfigā for Kria should have the details on choosing how loops are synced; you access this from Key 2, ie, the second black button on the front of the Ansible when you are in the Kria app.
Iāve been there a few times but originally itās just my email address for decades now after this had a strange and impactful influence on me in my youth:
That would be great. Iām not a coder so I really rely on reasonably accurate and coherent docsā¦
Due to whatever learning style I have, I need to spend a lot of time puzzling my way through manuals while trying to replicate the instructions with hands on the devices⦠if the docs are wrong, Iām pretty well screwed!
I do find the docs for monome and mannequins to be a bit oblique, and suspect they could be made somewhat more user-friendly⦠not a criticism, just an observationā¦
The Ansible documentation should be reasonably up-to-date - Iāve been trying to keep an eye on it, but I will admit that I am not up-to-date with a version running on my own module, and have lost track of versions. The community has been working on keeping it up-to-date, and Iāve certainly been trying to ensure that anyone adding or changing functionality also adds or changes the documentation in the same āpull requestā (request to change a bunch of code).
Iāll also note that the Ansible documentation is One Big Page primarily because thatās how itās written. The styling of the monome site itself possibly makes the delineations between apps hard to tell, and it just becomes one huge page thatās hard to skim; it might be that doing a page-per-app is more appropriate. Thatās a little project, and Iām on vacation for a bit so canāt really kick that off.
But I am going to suggest it here now, and perhaps as an enhancement ticket over at Github.
I just copied and pasted the docs for the different Ansible apps into their own word documents and made PDFs.
That works very well for me. A bit of compartmentalization can clear things up quite a bit.
Still, the Monome docs, even though far better than Mannequins, are not necessarily the most straight-forward manuals out there.
Otoh maybe that encourages some head-wrapping-around which may eventually lead to a better understanding.
In the doc it says āBy default Note Sync is on, and Loop Sync is set to Track.ā, but it seems that after updating the firmware (and thus resetting all presets) the default state for Loop Sync was āAllā.
The question is: is that intended new behaviour - the default changed, and it was meant to change, and now the docs should change - or is it an oversight on the part of whoever last touched the firmware? I donāt know the answer.
I think this is an error I made while editing the docs, loop sync has been ALL by default for at least three years. I will do a pass over the docs today to remove duplicate sections and check for correctness, very sorry for the trouble all.
Separate documentation pages for each of the apps would be a huge benefit and much appreciated. Iām struggling to learn Kria. Trying to search for something with browser Find (ctrl-F) often sends me into the docs for other apps which simply leads to more frustration when Iām trying to learn something basic.
separating out the apps into subpages makes a ton of sense.
I am happy to do this today, though I might wait on @csboling to glance the current version as one who is more familiar than myself with the current version
Shoot, I made a branch here to split Ansible apps out to their own files before I started reading through, and right after I pushed it I saw the discussion on github. Hope thatās not repeating work you already did @infovore! @tehn is there a build script I could use to confirm that the page cross-reference links work correctly? I donāt need to generate the whole site necessarily but am not sure what software is used to compile the markdown. Pandoc? Iāll give that a whirl here in a sec.