code5hot
commented
6 years ago FYI, I found some instructions that would almost meet the need of an evaluating user at http://docs.janusgraph.org/latest/server.html#server-getting-started
However, this shouldn't be the primary place for such a user to find it. It's important to gain confidence in the feature set without first learning about the architecture but one must know about the architecture to reach this point quickly with confidence that one isn't wasting one's time on too many possible avenues. Fortunately for me I'm prevaricating regards my chores so I took some extra weekend time to read a bit more.
It would be really good to list "easy evaluation installation and feature tutorial" as a feature on the main homepage and link directly to a page specifically for this need which directs an evaluator to the right sections in the expected chronological order.
It would be good to make it so that the links cause the style of the pages they link to also highlight the relevant text for an evaluator and to indicate the end of the relevant section. Evaluators are most able to avoid disregarding a tool that makes it totally obvious that it's the right tool for them.
User role
Evaluating user
Trying to achieve
Attempting to gain intuitions about what JanusGraph can do, how to interact with it usefully, and the costs of managing its infrastructure all of which I'm attempting to do in order to avoid excluding it as a useful tooling choice.
Steps to reproduce
Expected outcome
I find a really easy guide that can be completed with minimal human interaction, has only one significant waiting period at most, and requires only knowledge of the general purpose features of my computing platform and of its native installation and configuration procedures and of the clear guidance provided and linked in the guide. The introductions by the JanusGraph online presence give me confidence immediately when I find the guidance that it will be exactly that. I experience feelings of joy and new beginnings.
Actual outcome
I find no guide at all, after some searching via an independent search service that's currently happy to help me I find some discussion between third parties that advises what to do, due to the technical nature of the resource and that the official online presence doesn't list easy installation and configuration for my platform as a feature I conclude I'm going to lose time without a valuable return on the investment and that the only people who make it through installation will have more knowledge and spare time than will be available to me for my purposes. As a result I conclude, probably without fair justification, that JanusGraph will not be a good tool choice - even though, as an experienced technical person, I can see that its feature set is beautiful apart from this omission. I experience feelings of loss and sadness.