OpenRefine / OpenRefine/openrefine.org

Document the workaround steps for running OpenRefine on OS's that block running unsigned apps

Open
#139 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

documentation
Dominant language
TypeScript
Stars
161
Forks
142
Avg merge
6h 10m
Merged PRs (30d)
9

Description

Until we solve OpenRefine/OpenRefine#3003 and OpenRefine/OpenRefine#4568 we should document workaround steps.

Some OS's such as MacOS and Windows have additional steps needed for users to acknowledge installing applications downloaded from untrusted sources, or unsigned applications.

Proposed solution

Until OpenRefine has the capability to be considered an approved signed application for MacOS and Windows, we should:

  • provide workaround steps in our docs for running OpenRefine.
  • As a user, test on MacOS and Windows 10/11 that the workaround steps allow OpenRefine to be run.
Alternatives considered
Additional context

For example, here is a screenshot that could be added to our docs for Windows where running OpenRefine 3.5.2 openrefine.exe for the first time on Windows 11 where the user needs to click on More info and then click the button that appears Run anyway

image

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No documentation file is named, so first locate the guide covering installation or running OpenRefine. Document the workaround steps for unsigned apps on macOS and Windows, then test them on macOS and Windows 10/11; done means users can launch OpenRefine by following the documented steps.

Written by the indexing model from the issue text.

Assessment

Tech stack
macos
Domain
documentation, operating-systems
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.