feat: add readme

Author: migmartri

README.md

@@ -1,43 +1,57 @@
-# ChainLoop Bedrock
+# Chainloop Core
 
-## Projects
+> This is an early preview of the Chainloop Core project
+> and you should expect breaking changes before the first stable release.
 
-- `app/controlplane`
-- `app/artifact-cas`
-- `app/cli`
+## Overview
 
-See makefiles in those directories for more information
+**Chainloop Core (Chainloop)** is an open source project, a Control Plane for all your CI/CD engines.
 
-## Development
+![Chainloop Overview](./docs/img/overview-1.png)
 
-### Using Docker Compose
+Integration with existing pipelines is easy and requires only a few simple steps, including registration of a contract for the pipeline in the control plane, setup of the provided service account in the CI, and attestation crafting using Chainloop's CLI.
 
-You can run the core services (controlplane and CAS) and associated dependencies (postgresql) by running
+![Chainloop Overview](./docs/img/overview-3.png)
 
-```
-docker compose up
-```
+Chainloop provides:
 
-Then, the CLI can be run by doing
+- **Compliant Single Source of Truth.** A SLSA level 3 compliant single Source of truth for artifacts and attestation built on OSS standards such as Sigstore, in-toto, SLSA and OCI. Developers can craft and store attestation metadata and artifacts via a single integration point, regardless of their CI/CD provider choice.
+- **Contract-based attestation.** Workflow Contracts give operators full control over what kind of data (build info, materials) must be received as part of the attestation and the environment where these workflows must be executed.
+- **Third-Party Integration fan-out.** Operators can set up third-party integrations such as Dependency-Track for SBOM analysis or an OCI registry for storage of the received artifacts and attestation metadata.
+- **Observability/Auditability**. The control plane provides org-wide workflow, attestation, and artifacts visibility, including error rates, and operational anomalies.
+- Chainloop provides **a role-tailored experience**, clearly defining the responsibilities and functional scope of the Security/Operation (SecOps) and Development/Application teams.
 
-```
-docker compose run --rm cli
-```
+![Chainloop Overview](./docs/img/overview-2.png)
 
-Note that changes made in the source code are not reflected automatically in the running services, for that you'll need to perform a restart.
+To learn more, please visit the Chainloop project's documentation website, https://docs.chainloop.dev.
 
-```
-docker compose restart -t0 controlplane
-# or
-docker compose restart -t0 cas
-```
+## Documentation
 
-### Locally
+The documentation provides a getting started guide, FAQ, examples, and more.
 
-Prerequisites
+To learn more, please visit the Chainloop project's documentation website, https://docs.chainloop.dev.
 
-- postgresql
+## Community / Discussion / Support
 
-Note: You can run the prerequisites by leveraging the provided docker-compose file i.e `docker compose up postgresql`
+Chainloop is developed in the open and is constantly improved by our users, contributors and maintainers. Got a question, comment, or idea? Please don't hesitate to reach out via:
 
-Then each project has a `make run` target that can be used
+- GitHub [Discussions](https://github.com/chainloop-dev/chainloop/discussions),
+- GitHub [Issues](https://github.com/chainloop-dev/chainloop/issues),
+- or [Chainloop Discord Community Server](https://discord.gg/f7atkaZact).
+
+## Contributing
+
+Want to get involved? Contributions are welcome.
+
+If you are ready to jump in and test, add code, or help with documentation, please follow the instructions on
+our [Contribution](CONTRIBUTING.md) page. At all times, follow our [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+See the [issue tracker](https://github.com/chainloop-dev/chainloop/issues) if you're unsure where to start, especially the [Good first issue](https://github.com/chainloop-dev/chainloop/labels/good%20first%20issue) label.postpo
+
+## Changelog
+
+Take a look at the list of [[releases|http://github.com/chainloop-dev/chainloop/releases]] to stay tuned for the latest features and changes.
+
+## License
+
+Chainloop is released under the Apache License, Version 2.0. Please see the [LICENSE](./LICENSE.md) file for more information.