Docs Improvements/Suggestions

[Andrew5194]

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]

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]

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]

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]

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]

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

[Andrew5194]

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