Decentralized Issue Tracking for git
Rust
Switch branches/tags
Clone or download
neithernut Merge pull request #181 from neithernut/issue-metadata-doc-ambiguity
Make documentation of get-issue-metadata less ambiguous
Latest commit 3e189cf Jul 19, 2018

README.md

git-dit - the distributed issue tracker for git

WARNING: This is pre-1.0! Expect bugs and incompatibilities!

However, we try to avoid breaking changes.


git-dit features

  • Distributed issue tracking, without checking files into the repository
  • Convenient commandline interface (plumbing + porcelain)
  • Implemented as git subcommand: git dit
  • Each command has a --help
  • No structured data
    • An issue/comment is a commit
    • "Tags" are supported (see man git-interpret-trailers)
  • Convenience git dit push and git dit pull
  • No additional software needed on the server-side.

When playing with this, please keep in mind that this is alpha quality - there are bugs, missing things and rough edges.

Installing

Cargo is used for building git-dit. Run

cargo build

in this directory in order to build git-dit. Building the git-dit man page is enabled through the "manpage" feature of the Cargo package. E.g. run

cargo build --features manpage

instead.

We do not provide any installation scripts. If you intent using or testing git-dit, make sure to have the binary in your PATH.

Additionally, for building the man page, pandoc is required.

If you use Nixpkgs, it is also available as the attribute gitAndTools.git-dit, so you can try it out with simply nix-shell -p gitAndTools.git-dit.

Documentation

For a system overview and conceptual information, refer to the documentation. For a more practical documentation, refer to the man page.

License

The library module is licensed under terms of MPL-2.0. The binary module (this directory) uses the library and provides a commandline interface for it and is licensed under terms of GNU GPLv2.

(c) Julian Ganz, Matthias Beyer