Hacker News new | ask | show | jobs
by OmarIsmail 1359 days ago
The idea is solid but as someone who is in the market for something like this, the product doesnt currently inspire confidence. Specifically, you’re a tool to create User Guides and yet you haven’t created a user guide for your own site. If you don’t have user guides for your own service that indicates a few possibilities:

- the tool is too difficult to use for even yourself to be worth it

- you don’t use your tool deeply so you don’t have intuitive understanding of what is needed to be improve

- you don’t actually take user guides seriously and think they are important for a company to provide

When looking at this kind of service I’m evaluating on two levels: my customers experience, and my authoring experience. By not having your own user guide filled out I’m unable to evaluate the end customer experience (search, navigation, etc).

I know you’re in beta, but I don’t know why you’d do a show HN without at least having your own user guide filled out. A big wasted opportunity.

1 comments

> Specifically, you’re a tool to create User Guides and yet you haven’t created a user guide for your own site.

This was my exact thought. It's nice to have an easy-to-start demo, but I was expecting at least a link to a working (user-side) example.

Oh, sorry you missed that.

On homepage there is a guide to one of my other apps, blogstatic, using Subsection: https://blogstatic.io/guide/getting-started

And the Subsection one, which I am currently adding info to: https://subsection.io/guide

Subsection is about a week old and still improving it while in Beta.

Even that blogstatic "guide" is just one page.

It seems to me you're throwing a bunch of barely-built stuff at the wall to see what has traction to then actually build out. I don't think HN is a good way to do that. This now feels like a waste of everyone's time.

I think that’s a bit harsh. HN should absolutely be a place to try stuff out, as long as you’re clear about it. OP was mostly clear, even though the homepage copy might not be ideal.
Somehow I have missed your comment. Wanted to thank you the support. And, fixed most of the copy as we speak. Stating clearly the stage the product is in and what's to come. The intention was "to promise", but I can see now that some of the copy could have sounded as if everything is ready now. An honest semantics mistake.
Sorry about that. Did not mean to look like I am doing that.

Subsection is about a week old and I am slowly building out the guides for both our apps.

Also, there are currently two users who are using it to build out their User Guide and they will hopefully publish soon, so I can share their guides.