From e2d006d5639bc6ca39401f93ea21380aca1d6f86 Mon Sep 17 00:00:00 2001 From: Matthias Beyer Date: Fri, 6 Dec 2019 20:28:27 +0100 Subject: [PATCH] Rewrite README to contain less boilerplate text Signed-off-by: Matthias Beyer --- README.md | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 42dede2c..32cc1674 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ but we do not consider anything stable or usable at this moment. Feel free to play around anyways.** -## Goal / What is imag? +## Mission statement Our (long-term) goal is to @@ -15,9 +15,8 @@ Our (long-term) goal is to > suite of tools to cover all aspects of personal information management. Yes, imag is a rather ambitious project as it tries to reimplement functionality -for several "personal information management aspects". It is a hobby project, -keep that in mind. We try to use standards like vcard, icalendar and others -wherever possible. +for several "personal information management aspects". +We try to use standards like vcard, icalendar and others wherever possible. Have a look at [the documentation](./doc/) for some more words on this. @@ -27,18 +26,16 @@ Have a look at [the documentation](./doc/) for some more words on this. Here is how to try `imag` out. `imag` is a _suite/collection_ of tools (like git, for example) and you can -build them individually. -All subdirectories prefixed with "`libimag"` are libraries. -All subdirectories prefixed with `"imag-"` are binaries and compiling them will -give you a commandline application. +build each "module" individually. ### Building -We use `cargo` for building all crates in this repository. -Make sure to use a recent `cargo`, at least one with workspace support. Building all crates works with `cargo build --all`, building individual crates -by specifying the `--manifest-path` flag to cargo. +by specifying the `--manifest-path` flag to cargo. The crates in ./bin are the +actual commandline tools, ./bin/core contains a core set of imag commands +("plumbing" in git-speak) and ./bin/domain contains domain-specific imag +commands, for example a todo tool or a bookmark tool. ### Running