Suggestion for the docs

Ecosystem
1

Quick one before I get to GH:

  1. The two circled items seem identical, so some context just below “Guides” would be helpful

image
image784×371 83.9 KB

  1. Indentation: “Getting funds” is common to all scenario, it probably shouldn’t be under one specific approach

  2. “Launching a Storage Provider” - it’s required if you don’t use Docker, it appears, so maybe indent it under Local Testnet guides

Example:

Guides

You may run Polka Storage dockerized or from the CLI. If you use Docker, no binaries are required. If you use the CLI,

In either case, you will need to get funds and store a file, as these guides are common to both scenarios.

  • Building Polka Storage Stack
    • Binaries from Source
    • Docker containers from Source
  • Running Local Testnet
    • Overview
    • Steps
      • Running
        • Docker
        • Binaries
      • Getting testnet funds
      • Storing a file
      • Proving a file
      • [currently not available, but…] Downloading a file

Something like this would be more logical to me.

I use another Substrate network and I think many of those who are like me may not know much about the details of these Polkadot chains, parachains, etc. - but everyone can use Polkadot JS which means as long as the setup/running is transparent, they can get past the Polkadot part easily and use Polka-Storage without learning (more than necessary) about Polkadot itself.

Because I’m not familiar with Polkadot, I got lost in Docker vs. binaries, as I assumed I needed to follow the Local Testnet guide in addition to Docker (which I initially chose for simplicity), plus there are two of them, adding to my confusion, and then I had to decipher what each Polkadot part does, etc.

Cheers