docs: minor update to main readme

Signed-off-by: JP-Ellis <josh@jpellis.me>

Author: JP-Ellis

README.md

@@ -7,31 +7,26 @@
 
 > Reference implementations for the Pact Specification written in Rust
 
-This project contains a reference implementation of the [Pact specification](https://github.com/pact-foundation/pact-specification)
-written in Rust, often referred to as the Pact Core.
+This project contains a reference implementation of the [Pact specification](https://github.com/pact-foundation/pact-specification) written in Rust, often referred to as the Pact Core.
+
+It exposes the core functionality through various crates, as part of the Pact Rust SDK, as well as through FFI (Foreign Function Interface) and CLI (Command Line Interface) for use in other programming languages.
 
 ## Usage
 
 ### Rust
 
-For Rust projects, you can use the Rust crates from this library in your project directly. Refer to the [Rust project
-readme](rust/README.md). Requires minimum Rust 1.71.0.
-
-### Other languages
+For Rust projects, you can use the Rust crates from this library in your project directly. Refer to the [Rust project readme](rust/README.md).
 
-#### FFI
+### FFI
 
-This project contains dynamic libraries that expose the core functionality through FFI (Foreign Function Interface).
+This project contains dynamic libraries that expose the core functionality through a C-compatible FFI (Foreign Function Interface).
 
-For examples:
+This project contains a couple of examples which demonstrate how to use the FFI library in a C project, with a focus on showcasing how to call the FFI functions from C:
 
-* [C - Consumer](c/consumer-verification)
-* [C - Provider](c/provider-verification)
-* [Various Languages](https://github.com/YOU54F/hello_ffi)
+* [C - Consumer](c/consumer)
+* [C - Provider](c/provider)
 
-For implementations:
-
-[Ecosystem graph](https://docs.pact.io/diagrams/ecosystem#rust-ffi-consumers-goldberg-machine)
+Most of the Pact SDKs in other languages make use of this FFI library to provide Pact functionality. You can see this in the [Ecosystem graph](https://docs.pact.io/diagrams/ecosystem#rust-ffi-consumers-goldberg-machine), and the following examples:
 
 * [Javascript via pact-js-core](https://github.com/pact-foundation/pact-js-core)
 * [Ruby via pact-ruby-ffi](https://github.com/YOU54F/pact-ruby-ffi)
@@ -43,7 +38,9 @@ For implementations:
 * [C++ via pact-cplusplus](https://github.com/pact-foundation/pact-cplusplus)
 * [Python via pact-python](https://github.com/pact-foundation/pact-python)
 
-#### CLI
+Lastly, you can also refer to [Hello Pact FFI](https://github.com/YOU54F/hello_ffi) for collection of examples in various languages.
+
+### CLI
 
 This project contains code to support exposing the core functionality through CLI (Command Line Interface).
 
@@ -55,8 +52,7 @@ They are distributed in binary & Docker formats.
 
 ## Building
 
-To build the libraries in this project, you need a working Rust environment.  Requires minimum Rust 1.59.0.
-Refer to the [Rust Guide](https://www.rust-lang.org/learn/get-started).
+To build the libraries in this project, you need a working Rust environment.  Requires minimum Rust 1.59.0.  Refer to the [Rust Guide](https://www.rust-lang.org/learn/get-started).
 
 The build tool used is `cargo`.
 
@@ -73,7 +69,7 @@ See [CONTRIBUTING](CONTRIBUTING.md) (PRs are always welcome!).
 
 ## Documentation
 
-Rust library documentation is published to the Rust documentation site. Refer to the [Rust project README](rust/README.md).
+Rust library documentation is published to the Rust documentation site [`docs.rs`](https://docs.rs). Refer to the [Rust project README](rust/README.md).
 
 Additional documentation can be found at the main [Pact website](https://pact.io).
 
@@ -83,8 +79,8 @@ Join us in slack: [![slack](https://slack.pact.io/badge.svg)](https://slack.pact
 
 or
 
-- Twitter: [@pact_up](https://twitter.com/pact_up)
-- Stack Overflow: [stackoverflow.com/questions/tagged/pact](https://stackoverflow.com/questions/tagged/pact)
+* Twitter: [@pact_up](https://twitter.com/pact_up)
+* Stack Overflow: [stackoverflow.com/questions/tagged/pact](https://stackoverflow.com/questions/tagged/pact)
 
 ## Licensing