From 52c8c54c39240d8be8280466d223a60a2bcaedcd Mon Sep 17 00:00:00 2001 From: simonsan <14062932+simonsan@users.noreply.github.com> Date: Fri, 29 Mar 2024 19:10:47 +0100 Subject: [PATCH] add docs to service Signed-off-by: simonsan <14062932+simonsan@users.noreply.github.com> --- crates/cli/README.md | 10 +++++ crates/service/README.md | 89 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 99 insertions(+) create mode 100644 crates/service/README.md diff --git a/crates/cli/README.md b/crates/cli/README.md index 9b9369ee..a9a8eaae 100644 --- a/crates/cli/README.md +++ b/crates/cli/README.md @@ -33,6 +33,16 @@ You can ask questions in the | Discord | [![Discord](https://dcbadge.vercel.app/api/server/RKSWrAcYdG?style=flat-square)](https://discord.gg/RKSWrAcYdG) | | Discussions | [GitHub Discussions](https://github.com/orgs/pace-rs/discussions) | +## Crate features + +This crate exposes a few features for controlling dependency usage: + +- **clap** - Enables a dependency on the `clap` crate and enables parsing from + the commandline. *This feature is enabled by default*. + +- **cli** - Enables support for CLI features by enabling `merge` and `clap` + features. *This feature is enabled by default*. + ## Examples TODO! diff --git a/crates/service/README.md b/crates/service/README.md new file mode 100644 index 00000000..4471a514 --- /dev/null +++ b/crates/service/README.md @@ -0,0 +1,89 @@ +

+ +

+

pace-service - a service library for the pace ecosystem

+ +

+ + + + +

+ +## About + +`pace-service` is a library to support timetracking on the command line. It is +the service library for the `pace` timetracking application. + +⚠️ **Note:** `pace-service` is currently in active development and is not yet +ready for production use. Expect breaking changes and incomplete features. We +encourage you to try it out and provide feedback, but please be aware that it is +not yet stable. + +## Contact + +You can ask questions in the +[Discussions](https://github.com/orgs/pace-rs/discussions) or have a look at the +[FAQ](https://pace.cli.rs/docs/FAQ.html). + +| Contact | Where? | +| ------------- | --------------------------------------------------------------------------------------------------------------- | +| Issue Tracker | [GitHub Issues](https://github.com/pace-rs/pace/issues/new/choose) | +| Discord | [![Discord](https://dcbadge.vercel.app/api/server/RKSWrAcYdG?style=flat-square)](https://discord.gg/RKSWrAcYdG) | +| Discussions | [GitHub Discussions](https://github.com/orgs/pace-rs/discussions) | + + + +## Examples + +TODO! + +## Contributing + +Found a bug? [Open an issue!](https://github.com/pace-rs/pace/issues/new/choose) + +Got an idea for an improvement? Don't keep it to yourself! + +- [Contribute fixes](https://github.com/pace-rs/pace/contribute) or new features + via a pull requests! + +Please make sure, that you read the +[contribution guide](https://pace.cli.rs/docs/contributing_to_pace.html). + +## Code of Conduct + +Please review and abide by the general +[Rust Community Code of Conduct](https://www.rust-lang.org/policies/code-of-conduct) +when contributing to this project. In the future, we might create our own Code +of Conduct and supplement it at this location. + +## Minimum Rust version policy + +This crate's minimum supported `rustc` version is `1.74.1`. + +The current policy is that the minimum Rust version required to use this crate +can be increased in minor version updates. For example, if `crate 1.0` requires +Rust 1.20.0, then `crate 1.0.z` for all values of `z` will also require Rust +1.20.0 or newer. However, `crate 1.y` for `y > 0` may require a newer minimum +version of Rust. + +In general, this crate will be conservative with respect to the minimum +supported version of Rust. + +## License + +**AGPL-3.0-or-later**; see [LICENSE](./LICENSE).