The Dev Empowerment Team has been working on Holochain Core Concepts for the last several months. We are doing a soft release (Get Started + Core Concepts 1-6) and would like to get your feedback on the following:
Clarity of Content: Do you understand the concept and how it applies to your current knowledge?
Effective Examples: Is the example/metaphor appropriate? If not, can you propose another choice?
Usefulness: Is the content useful?
We would love to review and gather all feedback on the Forum. Each concept has an accompanying tutorial. Let us know if you are able to go through the content and tutorials.
I know your time is precious and we appreciate your investment. We’d like any feedback by Tuesday, 10/22. We’ll try our best to consider and incorporate the changes. We are starting a feedback schedule as we move these drafts to completion. We would like to include a period where we ask for feedback from the community and contributors like yourselves.
We have several things we want to revamp and/or deliver this quarter. Feel free to post any suggestions to the link above.
Thanks @dhtnetwork. I’ve been following the Core Concepts series for a while, and I think they’re the best resource out there for someone looking to understand agent centric architecture. Will share more detailed feedback soon.
Hi Sid, thank you for reviewing our content. We would appreciate any specific feedback/areas for improvement in the Get Started Section/Core Concepts/Tutorials. Looking forward to the detailed feedback.
FYI, we are working to revamp the Developer Portal homepage. We have a few design ideas and look forward to sharing with you and the community!
What’s next:
Developer Portal Homepage revamp (new design)
Journeys
Core Concepts 7-8
Core Concepts Tutorials 5-8
Holochain Glossary (text)
Holochain Visual Glossary/Visual Library
Holochain Dev Docs Roadmap
Polish/revisions to current Core Concepts (incorporate feedback, etc.)
I second that! Would love to know how these articles could improve — what they’re lacking, how approachable the tone is, whether we unpack the concepts in a logical order, etc.
Hey Paul et al, Great start. Your pictures are essential to break up the material so the reader can absorb what they are seeing. I think the chapter breakup and the way it is presented on the page is great.
Some feedback: I find scattering heaps of real world analogies should be used when possible. This can be either one for a topic, or a larger one that spans a few topics. For example, the DHT (chapter 4) is an alien concept for novices but the key to understanding how to use Holochain, so needs to ease the reader in…
I’d shift the material to start with “what is one” so move the Cloud of Witnesses further down. Alice living at address 180 needs to be more real world (and I was going to devote some thought to this for our next Meetup). I mean keep the techno language for later, such as “publishes an entry”. The radio tower thing further down the page is onto the right approach.
I also really like Paul’s design pattern things, these need to find their way into this material.
Thank you for the feedback Mike! We appreciate the review. Yes, we are slowly but surely revamping the entire Dev Portal. All the content will go through a review and feedback process. And we do have plans to incorporate the design patterns information.
Ditto to what @dhtnetwork says — thanks so much for the precise and concrete feedback @mikeg! Struggling to figure out a real-world example for DHT validator selection; if you dream up something for your Meetup, let me know! House addresses starts to come close to helping people visualise things spatially (maybe they live on a ring road or something). But as to the actual mechanics of validator selection… DHTs are a totally new thing in the world, so I don’t know that there is a concrete example! Maybe we simply have to state that fact.
When Art and Bear were down here earlier in the year they attempted the first ever “human DHT” at our Meetup. It was highly entertaining but a bit confusing But there is the challenge… analogies and examples
Thanks for the share! I really like the video, very human and pretty explanatory I reckon cut out a section from 28min to 55min and post that bit on YouTube @bear & @pauldaoust?
Thanks for an amazing content! @pauldaoust
There’s one concern I have which is that the tutorial is based on the diorama testing framework when holochain.love is already working with tri-o-rama. What I did with the translated work was to explain that this tutorial works with diorama testing framework and made the readers install the 0.0.29-alpha2 version of holochain.
other than that, awesome awesome content!
@tats_sato yep, updating the tutorials to Try-o-rama is on our near-term list of things to do. Thanks for flexing with our very rough, very rapidly mutating content!
exciting times 