JanusGraph / JanusGraph/janusgraph

The online presence of JanusGraph doesn't rapidly guide users into exploring the features and costs

Open
#1,024 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
5.8k
Forks
1.2k
Avg merge
13h 53m
Merged PRs (30d)
6

Description

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
---------------------------
1. Google for: janusgraph ubuntu
2. Open the two obvious high-level introduction pages in tabs:
- Chapter 3. Getting Started - JanusGraph Documentation
- JanusGraph: Distributed graph database
3. Read the two tabs looking for clues how to find a reliable and easy set of instructions to:
- install all prerequisites,
- install JanusGraph
- choose options and configure
or advice that such instructions should be expected to be available.
4. Read some pages from the immediate links looking for information about that.

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.

Contributor guide

Open the contributing guide

Research direction

Start with Chapter 3, “Getting Started - JanusGraph Documentation,” and the “JanusGraph: Distributed graph database” page, then review their immediate links. Done means providing a clearly linked installation and configuration guide covering prerequisites, options, platform setup, and expected waiting periods with minimal interaction.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.