Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

User Friendliness/ Documentation #98

Closed
Dripstylish opened this issue Apr 27, 2024 · 2 comments · Fixed by #133
Closed

User Friendliness/ Documentation #98

Dripstylish opened this issue Apr 27, 2024 · 2 comments · Fixed by #133
Labels
documentation Improvements or additions to documentation suggestion
Milestone

Comments

@Dripstylish
Copy link

First of all, what an amazing project! I'm blown away!

Though, while the UI itself is pleasant to look at and use, I do feel that there's a lack of user guidance.

It would be nice to see a more in-depth documentation on how to use the frontend, including the game mode, creative mode, world state manager, the agents...
Some buttons and areas have descriptions and tooltips. Some don't, and require a bit more time to understand. It would be nice with a bit more consistency and some time dedicated to writing up a solid User Guide showcasing all of it's features and possibilities.

@vegu-ai-tools
Copy link
Contributor

Hi @Dripstylish, thanks for the feedback.

I agree, i've been hesitant to dive "too deep" into documentation, simply because of how much i've been changing stuff around (drastically in some cases), but i feel a lot of the components that are there now that are stable enough that spending time on documentation makes sense.

What are the areas which have been the most unclear to you?

@vegu-ai-tools vegu-ai-tools added documentation Improvements or additions to documentation suggestion labels Apr 27, 2024
@Dripstylish
Copy link
Author

  1. The game mode and world state manager.
  2. The creative mode and how to create your own scenarios.
  3. Agent customization and potentially extending with custom agents - as well as the agent prompt template overwrites.
    I think the above is what most users would be interested in.

I'm aware that you have a few documentation files, for example about the templates. And I was able to learn a lot just from skimming the code base and watching the backend logs - but I don't think the average user would be able to do that.

If nothing else, then I think a "getting started" guide, that helps you through the more stable "game"-loop, would help make it a lot less daunting for a new user.

Since you're working in milestone releases, you could always keep two branches. One that's the current stable version, which has a documentation for it's features. And one that's still unstable and undocumented, which you move to stable only after updating the documentation.

@vegu-ai-tools vegu-ai-tools added this to the 0.26.0 milestone May 5, 2024
@vegu-ai-tools vegu-ai-tools mentioned this issue Jul 7, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation suggestion
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants