Skip to content

Latest commit

 

History

History
119 lines (91 loc) · 4.08 KB

CONTRIBUTING.md

File metadata and controls

119 lines (91 loc) · 4.08 KB
Raw

Contributing to Grapl

Thank you for your interest in contributing to Grapl! Community contributions such as yours are one of the key factors which differentiate Grapl in the DFIR ecosystem. This document is intended as a guide to help you contribute as effectively as possible.

First, please read our Code of Conduct. We expect all contributors to follow it.

Types of contributions

Here are some of the ways you can contribute to Grapl. All contributions are welcome, this is not meant to be an exhaustive list.

  • Feature requests or bug reports
  • Documentation
  • Plugins
  • Core features

Feature requests or bug reports

First, if you believe that you have identified a security vulnerability which affects Grapl users, please do not open a public GitHub issue. Instead, please contact us via email at [email protected], and we will work with you to resolve it safely and quickly.

For all non-sensitive feature request or bug reports, please open a Bug report GitHub Issue containing a detailed, reproducible description of the problem. It may be useful to discuss the issue before opening one in GitHub, if you'd like you may reach out via Slack at the Grapl slack channel (Click for invite), but this is not a requirement.

Changes to code or documentation

Grapl is organized as a monorepo with the following structure:

/grapl
├──etc
│  ├──images
│  ├──local_grapl
│  └──sample_data
└──src
   ├──js
   │  └──{ js services …
   ├──python
   │  └──{ python services …
   └──rust
      └──{ rust services …

We use GNU Make, Docker (version 20.10 or later) and docker compose for local development. To execute a Grapl debug build, execute the following command in the project root:

make build

You can see all the Make targets available by running make help in Grapl root.

See BUILDING.md for a more in-depth description of Grapl's build system.

To run your images locally, execute the following command in the project root (after building):

make up

See our ReadTheDocs for a more in-depth guide to operating Grapl.

We heartily welcome code contributions, but we request for the sake of planning and project management that each contribution be associated with an open issue. Please communicate with us before starting development so we can make sure everyone is on the same page and avoid wasting time and effort.

Pull requests should be made against the main branch. We will deploy and test all changes in our main environment before we cut a release-candidate branch from the main branch.

Documentation

Documentation is definitely a work-in-progress at this point. In the likely event you find it lacking, please open a Documentation request GitHub Issue. For minor edits like spelling, correctness, grammar, etc., don't worry about opening an issue, just submit a PR.

Plugins

Grapl aims to provide a rich plugin ecosystem to integrate with external systems. If you have any suggestions for new plugin integrations please open a Plugin request GitHub Issue.

Core features

For updates to Grapl's core functionality please open a Feature request GitHub Issue.

Other issues

For any issue not covered in the rest of this document, please feel free to open a blank GitHub Issue. Please include as much information as you can to help us address it.