Skip to content

README.md

Latest commit

 

History

History
125 lines (89 loc) · 4.28 KB

README.md

File metadata and controls

125 lines (89 loc) · 4.28 KB

Workflow Discord Try Free

Trendshift

FalkorDB Documentation

Welcome to the FalkorDB documentation repository. This repository contains the source files for https://docs.falkordb.com.

About FalkorDB

FalkorDB is a low-latency, scalable graph database with OpenCypher support. It powers GraphRAG applications and serves as a high-performance property graph database for complex, interconnected data.

Documentation Structure

  • Getting Started: Installation, configuration, and client libraries
  • Cypher: Query language reference and examples
  • Commands: FalkorDB-specific commands
  • Algorithms: Graph algorithms (BFS, PageRank, etc.)
  • GenAI Tools: Integration with LlamaIndex, LangChain, and GraphRAG frameworks
  • Operations: Deployment, clustering, and infrastructure
  • Integration: Third-party tool integrations

Prerequisites

To build and run the documentation locally, you need:

  • Ruby (2.7 or later)
  • Bundler gem

Local Development

Install Dependencies

bundle install

Build the Documentation

bundle exec jekyll build

Run Local Server

bundle exec jekyll serve

The documentation will be available at http://localhost:4000.

Contributing

We welcome contributions to improve the documentation! Here's how you can help:

Reporting Issues

If you find errors, typos, or unclear explanations:

  1. Check if an issue already exists in the issue tracker
  2. If not, create a new issue with:
    • Clear description of the problem
    • Location in the documentation (file path and line number)
    • Suggested improvement (if applicable)

Submitting Changes

  1. Fork the repository
  2. Create a feature branch (git checkout -b improve-documentation)
  3. Make your changes
  4. Test locally with bundle exec jekyll serve
  5. Commit your changes with clear, descriptive messages
  6. Push to your fork
  7. Open a Pull Request with:
    • Description of changes
    • Reason for the changes
    • Screenshots (if visual changes)

Style Guidelines

  • Use clear, concise language
  • Include code examples where appropriate
  • Follow existing formatting and structure
  • Test all code examples
  • Use proper Markdown syntax
  • Keep line length reasonable (under 120 characters when possible)

Code Examples

When adding code examples:

  • Provide examples in multiple languages when applicable (Python, JavaScript, Java, Rust)
  • Ensure code is tested and working
  • Include comments for complex operations
  • Use realistic, meaningful variable names

Project Structure

docs/
├── algorithms/          # Graph algorithms documentation
├── commands/            # Command reference
├── cypher/             # Cypher query language docs
├── genai-tools/        # AI/ML integrations
├── getting-started/    # Installation and setup
├── integration/        # Third-party integrations
├── operations/         # Deployment and operations
├── udfs/              # User-defined functions
├── _config.yml        # Jekyll configuration
└── index.md           # Homepage

License

The documentation is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).

FalkorDB itself is licensed under the Server Side Public License v1 (SSPLv1).

Support