docs: Surface Cypher in overviews + minor repo cleanup#1393
Merged
Conversation
Cypher (openCypher) is a supported read/write surface alongside JSON-LD Query and SPARQL, but several overview and reference docs still enumerated only "JSON-LD and SPARQL". Update them to name all three languages and document the previously-missing CLI and HTTP Cypher entry points. - query/README.md: add Cypher as a third query language with examples - getting-started quickstarts + tutorial + concepts: name all three surfaces - api/endpoints.md, api/overview.md, operations/running-fluree.md: document Content-Type: application/cypher on the ledger-scoped routes - transactions overview/README: add Cypher as a write format - cli/query.md, cli/update.md, cli/README.md: document --cypher / --format cypher and the format auto-detection rules - drop "openCypher subset" phrasing in favor of the support matrix
- Delete scripts/import-memory-repro.sh (one-off cgroup OOM repro) and drop its now-dangling reference from the stress_upload_memory doc comment - Untrack .cursor/ and gitignore it (kept locally, editor-specific)
aaj3f
approved these changes
Jul 5, 2026
| with `Content-Type: application/cypher` to the ledger-scoped query endpoint: | ||
|
|
||
| ```bash | ||
| curl -X POST http://localhost:8090/v1/fluree/query/mydb/main \ |
The greedy /query/*ledger tail captures the path literally, so the slash form resolved to a ledger named 'mydb/main'. Match the colon convention used everywhere else in the docs.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Small docs + housekeeping pass.
Docs: Cypher (openCypher) is a supported read/write surface alongside JSON-LD Query and SPARQL, but several overview/reference docs still enumerated only "JSON-LD and SPARQL". Updated the query, transaction, getting-started, and CLI/API docs to name all three languages and document the previously-missing CLI (
--cypher/--format cypher) and HTTP (Content-Type: application/cypher) entry points.Cleanup:
scripts/import-memory-repro.sh(one-off debug repro) and its dangling doc-comment reference.cursor/editor config and added it to.gitignore(kept locally)