Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Help users download the tool easily #317

Open
romicolman opened this issue Apr 11, 2024 · 2 comments
Open

Help users download the tool easily #317

romicolman opened this issue Apr 11, 2024 · 2 comments
Assignees
Labels
comms Comms improvements or additions Documentation Issues related to ODE documentation U1 As a journalist, I want to be able to install the ODE easily so I can explore and validate my data

Comments

@romicolman
Copy link
Collaborator

Problem description

For non technical users, it is complicated to understand how to download the tool. If you visit the OKFN page of the tool, the Getting started redirects to the user guide. While it is true the guide explains the user how to download the ODE, it is not intuitive.

Captura de pantalla 2024-04-11 a la(s) 14 36 20

Steps to reproduce the problem

Suggested solution

The tool Tabula, allows users to download the app directly from the project page:

Captura de pantalla 2024-04-11 a la(s) 15 04 42

However, this cannot be added without context. Since the the ODE potential user is someone with non-coding skills, I think it would be good to add a short sentence to explain actions. For example: "Donwload the tool and click on the dmg file to run it". Open to your insights/ suggestions @lucpretti

@romicolman romicolman added comms Comms improvements or additions U1 As a journalist, I want to be able to install the ODE easily so I can explore and validate my data Documentation Issues related to ODE documentation labels Apr 11, 2024
@romicolman romicolman assigned pdelboca and unassigned lucpretti Apr 22, 2024
@romicolman
Copy link
Collaborator Author

@pdelboca more info to be added to the page:

  • ODE description: it should be the same that we have right now in the readme: "The Open Data Editor (ODE) is a no-code application to explore, validate and publish data in a simple way. Forever free and open source project powered by the Frictionless Framework".
  • 📍Note: the ODE is currently available for download and testing in beta. We are working on a stable version. Updates will be announced throughout the year.
  • Replace the Get Started button with Documentation
  • Keep the View on GitHub button
  • Add the following items.

📩 Send us feedback/Report a problem (email) 🪲 Create an issue on GitHub 🤔 Suggest a new feature

Please, check the best position for this info with @lucpretti

@lucpretti we can also add something like ODE latest news and redirect to the OKFN blog. What do you think?

@romicolman
Copy link
Collaborator Author

@lucpretti can you delete the concept note from the project page, add the following message in the first slide and then re-upload it again?

Suggested text (feel free to edit it):

📍Note: we are currently updating ODE's concept note to adjust it to the product vision for the stable version. Because of this, some of the features listed here may change. Please, follow our blog to get the latest updates.

We also need to add a message in the user guide. This is the suggested text. Again, at the top of the page:

📍Note: we are currently working on the stable version of the ODE. Because of this, some of the features listed in this guide may change. Please, follow our blog to get the latest updates.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
comms Comms improvements or additions Documentation Issues related to ODE documentation U1 As a journalist, I want to be able to install the ODE easily so I can explore and validate my data
Projects
None yet
Development

No branches or pull requests

3 participants