Update documentation to include Mac OS verification step

[paulgronke]

Hello, not sure if this is a Mac OS issue (currently running Sonoma), but when I attempt to open the RCV script, i receive a security warning for "java" (see image).

Typically, a user can override the security protections for a trusted executable, but in this case, I think the java executable is being called from w/in the "rcv" script, so I have no option to override the settings.

We should include this explicitly in the (forthcoming) user guide documentation. See Paul's comment below for information on exactly how he got to this issue.

[paulgronke]

Resolved. MacOS users will need to execute the "java" script first in order to establish this as a trusted executable. Follow this by the "rcv" script and the GUI appears.

[yezr]

thanks for the heads up Paul! I'm make sure to include this in our documentation. We're working on a friendlier and more accessible user guide. Something like this would be great to include in there.

[yezr]

Did you build from source with gradle? How exactly did you get to this error?

[paulgronke]

Platform: MacBook Pro running Sonoma 14.5 Did not build from source. Here is how I obtained the error: 1) Downloaded “universal_rcv_tabulator_v1.2.0_mac.zip” from https://github.com/BrightSpots/rcv/releases (downloaded this version because the county I am working with has to use the VVSG certified version). 2) Unzipped the archive 3) First attempt to run: right click on “rcv” which is identified by the MacOS as a unix executable. This generates an onscreen dialog box warning the user that this executable was downloaded from the internet and do you trust it. Clicked “run”. This opens a terminal window and a security error. 4) Second attempt: right click on “java” in the same folder, under the assumption that the RCV script calls the java executable, and the MacOS requires the same security authorization for the java script. Once the java script has been authorized=, go back to executing the “rcv” script and the java window opens.

…

--- Paul Gronke Professor, Reed College Director, Elections and Voting Information Center http://evic.reed.edu General Inquiries: Michelle Shafer, ***@***.***

On Jun 28, 2024, at 5:32 AM, Mathew Ruberg ***@***.***> wrote: Did you build from source with gradle? How exactly did you get to this error? — Reply to this email directly, view it on GitHub <#858 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AGBOF6FSIDM6SQ3XYHNXKJLZJVJXJAVCNFSM6AAAAABKAY64X6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCOJWHAYDMMJRG4>. You are receiving this because you modified the open/close state.