From f5590e375571ef1979c4a81ec1d7b2fa84536185 Mon Sep 17 00:00:00 2001 From: Martin Hutchinson Date: Wed, 21 Aug 2024 15:20:30 +0100 Subject: [PATCH 1/2] README: direct users to the examples We can come back and add example usage in this main README if that's useful, but for now pointing to the examples that are fleshed out and are known to compile is a pragmatic step forward. It also gives newcomers links to binaries they can run to understand what Tessera can do, before they start writing any code. --- README.md | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 219da737..78e5b10a 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ over the past decade of building and operating transparency logs in production e Tessera goals: -* [Tiles-native API](https://github.com/C2SP/C2SP/blob/main/tlog-tiles.md) and storage +* [tlog-tiles API][] and storage * Support for both cloud and on-premises infrastructure * GCP and AWS support will be provided initially * Cloud agnostic MySQL and POSIX filesystem support @@ -27,7 +27,7 @@ Tessera goals: * Broadly similar write-throughput and write-availability, and potentially _far_ higher read-throughput and read-availability compared to Trillian v1 (dependent on underlying infrastructure) * Enable building of arbitrary log personalities, including support for the peculiarities of a - [Static CT API](https://c2sp.org/static-ct-api) compliant log. + [Static CT API][] compliant log. ### Status @@ -48,17 +48,16 @@ migration to Tessera and adopting the patterns it encourages. ### Getting started -#### Usage +Take a look at the example personalities in the `/cmd/` directory: + - [example-posix](./cmd/example-posix/): example of operating a log backed by a local filesystem + - This example is not a long-lived process; running the command integrates entries into the log which lives only as files + - [example-mysql](./cmd/example-mysql/): example of operating a log that uses MySQL + - This example is easiest deployed via `docker compose`, which allows for easy setup and teardown + - [example-gcp](./cmd/example-gcp/): example of operating a log running in GCP + - This example can be deployed via terraform (see the [deployment](./deployment/) directory) -```go - -import ( - tessera "github.com/transparency-dev/trillian-tessera" -) - -// TODO... - -``` +The `main.go` files for each of these example personalities tries to strike a balance when demonstrating features of Tessera between simplicity, and demonstrating best practices. +Please raise issues against the repo, or chat to us in [Slack](#contact) if you have ideas for making the examples more accessible! ### Contributing @@ -77,3 +76,6 @@ This repo is licensed under the Apache 2.0 license, see [LICENSE](/LICENSE) for Tessera builds upon the hard work, experience, and lessons from many _many_ folks involved in transparency ecosystems over the years. + +[tlog-tiles API]: https://c2sp.org/tlog-tiles +[Static CT API]: https://c2sp.org/static-ct-api From 32e415ec252c21f88464b7bdde413b4d24b49be8 Mon Sep 17 00:00:00 2001 From: Martin Hutchinson Date: Wed, 21 Aug 2024 15:32:28 +0100 Subject: [PATCH 2/2] Plurality adjustment --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 78e5b10a..5d59a4ad 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@ Take a look at the example personalities in the `/cmd/` directory: - [example-gcp](./cmd/example-gcp/): example of operating a log running in GCP - This example can be deployed via terraform (see the [deployment](./deployment/) directory) -The `main.go` files for each of these example personalities tries to strike a balance when demonstrating features of Tessera between simplicity, and demonstrating best practices. +The `main.go` files for each of these example personalities try to strike a balance when demonstrating features of Tessera between simplicity, and demonstrating best practices. Please raise issues against the repo, or chat to us in [Slack](#contact) if you have ideas for making the examples more accessible! ### Contributing