ifdef::env-github,env-browser[:outfilesuffix: .adoc]
= The Cypher Property Graph Query Language
This repository holds the specification of Cypher, a declarative property graph query language. Its purpose is to be central to the process of evolving the specification and standardisation of Cypher as a graph query language.
== Overview of the process
Changes to openCypher are made through consensus in the openCypher Implementers Group (oCIG). The process for proposing changes, voting on proposals and measuring consensus is described in https://docs.google.com/presentation/d/1OHMxiz9xW6rINiJcCdm28a8uNcZEtCsMPfhFSIA-XXE/edit[this set of slides].
Refer to the link:CIP-PROCESS.adoc[Cypher Improvement Process] document for more details on CIPs, CIRs, their structure and lifecycle.
== The structure of this repository
/cip
** Contains a list of accepted CIP documents./grammar
Contains the Cypher grammar specification, in XML source format.
A more readily consumable form of the grammar is generated as output from the build and https://opencypher.org/resources/[can be found here]:
Railroad diagrams
EBNF
*** ANTLR4 Grammar/tck
** Contains a set of Cucumber features that define Cypher behaviour, and documentation on how to use it./tools
** Contains code that tests the integrity of the repository, generates release artifacts, and aids implementers of openCypher.== Building
This repository uses a Maven build and supports cross building for Scala 2.12 and Scala 2.13:
For Scala 2.12, use mvn -U clean install -P scala-212
For Scala 2.13 use mvn -U clean install -P scala-213
== Contact us
There are several ways to get in touch with the openCypher project and its participants:
== Copyright
© Copyright 2015-2017 Neo Technology, Inc.
== Feedback
Any feedback you provide to Neo Technology, Inc. through this repository shall be deemed to be non-confidential. You grant Neo Technology, Inc. a perpetual, irrevocable, worldwide, royalty-free license to use, reproduce, modify, publicly perform, publicly display and distribute such feedback on an unrestricted basis.
== License
The openCypher
project is licensed under the http://www.apache.org/licenses/LICENSE-2.0[Apache license 2.0].
// TODO: I feel like we should flesh this section out a bit -- not sure how