Skip to content
This repository has been archived by the owner on Aug 2, 2021. It is now read-only.

Clean up Swarm UX (CLI + config) #1100

Open
8 tasks
cobordism opened this issue Jan 10, 2019 · 1 comment
Open
8 tasks

Clean up Swarm UX (CLI + config) #1100

cobordism opened this issue Jan 10, 2019 · 1 comment
Labels
cli Swarm command line interface

Comments

@cobordism
Copy link

cobordism commented Jan 10, 2019

These issues are summarised in the following EPIC:
ethersphere/user-stories#13


What this is about

The Swarm CLI interface, the configuration, the options, and the error messages have grown organically over time. As the project matures and gets more users, it is important that we dedicate time to clean it up and keep it organised.

This issue lists some points that could be addressed
In the long term we should have a more dedicated process for evaluating and improving UX.

Some points that could be fixed (in no particular order).

  • 1. A configuration file should be created in the swarm directory with all defaults included and #commented out (as is standard practice) making it easy to understand and edit.
  • 2. The --bzzaccount option should not be mandatory, especially if there is a single bzz data directory. (i.e. the default option should be bzzaccount=auto)
  • 3. order of CLI flags should not matter whenever possible (eg swarm up --recursive vs swarm --recursive up)
  • 4. Cleanly separate the swarm subcommands up, db, version etc. (You should never see an error from swarm startup like Fatal: bzzaccount option is required but not set when you are actually just trying to upload content to swarm but just got some cli flag wrong.)
  • 5. Have a separate swarm start type command to launch a swarm node (see previous point)
  • 6. The error no peers found should make clear if it is a swam error or a geth/ENS error (applies to HTTP error page as well)
  • 7. Have a status page showing storage usage, connectivity, error log, mainnet/ropsten ENS status, ... anything that makes this info more accessible and clear to users.

  • please suggest more points below
@cobordism cobordism added the cli Swarm command line interface label Jan 10, 2019
@cobordism cobordism added this to Backlog in Swarm Core - Sprint planning via automation Jan 10, 2019
@acud
Copy link
Member

acud commented Jan 14, 2019

related to #490

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
cli Swarm command line interface
Projects
No open projects
Development

No branches or pull requests

2 participants