Skip to content

This issue was moved to a discussion.

You can continue the conversation there. Go to discussion →

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

Ideas - how to simplify view for new users? #539

Closed
keyserj opened this issue Oct 21, 2024 · 5 comments
Closed

Ideas - how to simplify view for new users? #539

keyserj opened this issue Oct 21, 2024 · 5 comments
Labels
clarity makes something easier to understand learn app helps people learn how to use Ameliorate needs ux design User experience should be solidified before implementing
Milestone

Comments

@keyserj
Copy link
Collaborator

keyserj commented Oct 21, 2024

Diagrams are pretty hard to read if you're unfamiliar with Ameliorate, especially if they're larger diagrams.

It'd be useful if

  1. changes could make diagrams easier to read, or
  2. there was a simplified view that could be shown by default.

This ticket's purpose is to organize all ideas that can make it easier for Ameliorate to be understood by new users, and provide a place to discuss these ideas. Concrete ideas that should be implemented should have their own tickets and be linked to this one.

Existing related tickets:

@keyserj keyserj added needs ux design User experience should be solidified before implementing clarity makes something easier to understand learn app helps people learn how to use Ameliorate labels Oct 21, 2024
@keyserj keyserj added this to the update #5 milestone Oct 21, 2024
@keyserj
Copy link
Collaborator Author

keyserj commented Oct 21, 2024

Idea: limit shown diagram to X layers from the selected node (solution/problem/etc)

Good:

  • showing just a few layers can help provide a quick high-level for the user, and the user can click to navigate deeper layers as they want

Bad:

  • Quick Views already allow the topic creator to manually set this up
  • topics vary in breadth (nodes per layer), so it seems like there wouldn't be a good default for all topics (e.g. a topic with 1-2 nodes per layer but 4-5 layers might make more sense to show more layers at once)
  • topics vary as to which view provides the best high-level; some might be best starting from a problem, some might be best from a solution, some might be best from the criteria table

@keyserj
Copy link
Collaborator Author

keyserj commented Oct 21, 2024

Kialo has some great UX that's intuitive for new users, maybe inspiration can be taken from that.

Guided voting: shows one claim at a time, and another is shown after that one is scored

@keyserj
Copy link
Collaborator Author

keyserj commented Oct 21, 2024

Kialo's sunburst navigation is a nice visual to convey depth of layers from one root node
image

  • since there's no clear root in Ameliorate (e.g. could be multiple problems, multiple solutions), and nodes can have X parents/children, this visual wouldn't exactly work to show the whole diagram
  • perhaps googling for different concise visuals to view a whole graph could be good
  • potentially something similar could be done except with problems on the left, solutions on the right, details in between, and all nodes/edges are just replaced by tiles of color that can be hovered to show the node's text, like cars-going-too-fast could be represented like this:
    image

@keyserj
Copy link
Collaborator Author

keyserj commented Oct 21, 2024

Kialo's tree navigation is also nice way of contextualizing where you are in the diagram
image

  • Ameliorate could just show a mini/no-text version of the graph, with hiding any nodes not between the selected node and the root problems/solutions

@keyserj
Copy link
Collaborator Author

keyserj commented Oct 21, 2024

Kialo's simple 2-column view is easy for new users to navigate:
image

  • but Ameliorate uses a graph, not a tree, so could something like this even be done?
    • potentially a view could show the selected node's parents, siblings, and children, and a minimap solution (like sunburst/tree navigation) could be sufficient for context; and selecting a different node would move it to the center row and show its own neighbors
      • e.g. with cars-going-too-fast if "30 day implementation" component is selected, might look like this
        image

@amelioro amelioro locked and limited conversation to collaborators Oct 21, 2024
@keyserj keyserj converted this issue into discussion #541 Oct 21, 2024
@github-project-automation github-project-automation bot moved this to ✅ Done in ameliorate Oct 21, 2024

This issue was moved to a discussion.

You can continue the conversation there. Go to discussion →

Labels
clarity makes something easier to understand learn app helps people learn how to use Ameliorate needs ux design User experience should be solidified before implementing
Projects
Status: Done
Development

No branches or pull requests

1 participant