valist-io / valist

Web3-native software distribution. Publish and install executables, Docker images, WebAssembly, and more. Powered by Ethereum, IPFS, and Filecoin.
https://valist.io
Mozilla Public License 2.0
116 stars 6 forks source link

Docs Improvements/Suggestions #278

Open Andrew5194 opened 2 years ago

Andrew5194 commented 2 years ago

Hopefully this goes here, but feel free to close this issue or move around as necessary :P. Took a look at https://docs.valist.io/core-concepts/web3-native-software-distribution and you seem to explain "What is the Big Picture" and "How It Works", but as a potential user to Valist, what I really care about is "Why Should I use Valist?". What benefits am I getting over how I currently operate/distribute my code? Am I saving money, and if so how much? Is there better security, and if so, what are the clearly defined flaws with how I currently operate (and the specific systems that I may use)? Or perhaps I'm saving time because your application is super easy to use? Do you have any facts/statistics/use cases that support using your idea over the status quo? Answering things of this nature and having a section on the front page of your docs (https://docs.valist.io/) would be a better funnel to pique the interest of more potential users.

(I believe you start to touch upon this with the sections on "DAO-coordinated software", "Software License NFTs", and "Proof of Contribution", but these sections seem to be formed around the narrative of "here's what using Valist allows you to do", but framing around "here's what's wrong with how you're currently operating, and with Valist what you can achieve" would probably be more poignant).

Also, a video walkthrough would be nice for the more "let me just watch and listen" type of users. Hope this helps!

Edit: I see you do have a video walkthrough on https://docs.valist.io/core-concepts/software-license-nfts/token-gating-your-software but this could probably be more front-and-center.

Andrew5194 commented 2 years ago

Also, didn't you have a high-end introduction video at some point? What happened to that video? I remember it had a pretty decent/succinct explanation as to what Valist was all about. (Also, it helped put your faces to the company name/product, which is sometimes helpful when people are looking to place their faith in your product, i.e. I want to work with someone who I find genuine and competent).

Andrew5194 commented 2 years ago

Doing some more brain dumping here, but it would also be cool to see an end-to-end tutorial/walkthrough of "hey I have this application that I currently use and distribute via AWS, GCP, GitHub, whatever, now look at how easy it is to migrate your existing codebase and put it on Valist", and then proceed to showcase the same functionality but now with all the better features that Valist provides. Do you guys have any available real-world use cases that you can showcase rather than quick demos?

Andrew5194 commented 2 years ago

Another suggestion, I see you have https://github.com/valist-io/valist-github-action, which I would presume automates the migration of my code on GitHub over to Valist. Show me a tutorial walkthrough/video on this! This would fold into the above comment that I posted:

Doing some more brain dumping here, but it would also be cool to see an end-to-end tutorial/walkthrough of "hey I have this application that I currently use and distribute via AWS, GCP, GitHub, whatever, now look at how easy it is to migrate your existing codebase and put it on Valist", and then proceed to showcase the same functionality but now with all the better features that Valist provides. Do you guys have any available real-world use cases that you can showcase rather than quick demos?

jiyuu-jin commented 2 years ago

Hopefully this goes here, but feel free to close this issue or move around as necessary :P. Took a look at https://docs.valist.io/core-concepts/web3-native-software-distribution and you seem to explain "What is the Big Picture" and "How It Works", but as a potential user to Valist, what I really care about is "Why Should I use Valist?". What benefits am I getting over how I currently operate/distribute my code? Am I saving money, and if so how much? Is there better security, and if so, what are the clearly defined flaws with how I currently operate (and the specific systems that I may use)? Or perhaps I'm saving time because your application is super easy to use? Do you have any facts/statistics/use cases that support using your idea over the status quo? Answering things of this nature and having a section on the front page of your docs (https://docs.valist.io/) would be a better funnel to pique the interest of more potential users.

(I believe you start to touch upon this with the sections on "DAO-coordinated software", "Software License NFTs", and "Proof of Contribution", but these sections seem to be formed around the narrative of "here's what using Valist allows you to do", but framing around "here's what's wrong with how you're currently operating, and with Valist what you can achieve" would probably be more poignant).

Also, a video walkthrough would be nice for the more "let me just watch and listen" type of users. Hope this helps!

Edit: I see you do have a video walkthrough on https://docs.valist.io/core-concepts/software-license-nfts/token-gating-your-software but this could probably be more front-and-center.

Love this!

awantoch commented 2 years ago

thanks for all of the feedback @Andrew5194, this is amazing -- will review/digest/implement! 🙏

Andrew5194 commented 2 years ago

You've seen this gif before, just imagine the dancing :)

image