JanusGraph / JanusGraph/janusgraph

Possible incosistency in chapter 5 documentation

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

Description

In Chapter 5. Schema and Data Modeling first there is paragraph:

> The default cardinality setting is SINGLE. Note, that property keys used on edges and properties have cardinality SINGLE. Attaching multiple values for a single key on an edge or property is not supported.

and then example:

```
mgmt = graph.openManagement()
follow = mgmt.makeEdgeLabel('follow').multiplicity(MULTI).make()
name = mgmt.makePropertyKey('name').dataType(String.class).cardinality(Cardinality.SET).make()
mgmt.addProperties(follow, name)
mgmt.commit()
```

doesn't this example contradict that edges can't have multiple values for a single key?

Contributor guide

Open the contributing guide

Research direction

Start with Chapter 5, “Schema and Data Modeling,” and compare the paragraph about SINGLE cardinality with the shown edge-label and property-key example. Determine whether the example contradicts the explanation, then clarify the documentation so the supported cardinality behavior is unambiguous.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
databases, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.