What even is Spook?

[AlexKalopsia]

Someone recently shared Spook in reddit, was pretty hard to understand what spook is from the docs. Take this as constructive feedback, it's very unclear what Spook does. No info on the landing page, some of it is in Getting Started but it quickly jumps to Install before I even have a clear understanding of why I need this tool. It just feels very vague from start to end. My recommendation is to write down a few clear and succinct user stories that as a user I can look at and say "oh alright, this sounds like I could use this". Right now it just mostly says "we add more stuff". The project seems really well structured otherwise

[frenck]

Have you read:

• https://spook.boo/about
• https://spook.boo/features
• https://spook.boo/core-extensions
• https://spook.boo/enhanced-integrations
• https://spook.boo/background-and-history
• https://spook.boo/faq

?

[AlexKalopsia]

Well, that pretty much underlines what I am talking about, what it does is spread across multiple pages and a new user needs to get it from the get go. For instance nowhere in the landing page it says what it does! It just says "if you want to start using it, go to Getting Started", but I don't wanna start using it if I don't know what it is or what it does.

In Getting Started the very section "what does it do" doesn't tell me what it does, it just vaguely says that it does stuff that HA doesn't support. Well, again, I don't know what you are referring to haha.

In "What do I get from spook" it is mentioned that I will get new features to actions and new entities. Again, I dont know what these are and why I'd want them, hence why I say that using User Stories would be beneficial to the docs, to give clear and appealing use cases to new users. Things to say "oh hell yeah, I want this capability that I didnt have otherwise".

[frenck]

what it does is spread across multiple pages and a new user needs to get it from the get go.

If you read it, you'd probably realize that what you are asking for is pretty unrealistic.

n Getting Started the very section "what does it do" doesn't tell me what it does, it just vaguely says that it does stuff that HA doesn't support. Well, again, I don't know what you are referring to haha.

If you are not willing to read the rest, I really think you shouldn't be using this thing anyways. So if this is the point you stop reading and lost interest; that is fine by me 👍

../Frenck