[docsy] Streamline and refactor Getting started section

content/en/_index.md

@@ -17,7 +17,7 @@ developer_note: |
 {.display-6}
 
 <a class="btn btn-lg btn-primary me-3" href="docs/overview/">Learn More</a>
-<a class="btn btn-lg btn-secondary" href="docs/get-started/">Get started</a>
+<a class="btn btn-lg btn-secondary" href="docs/getting-started/">Get started</a>
 {.p-initial .my-5}
 
 {{% /blocks/cover%}}
@@ -41,9 +41,8 @@ Used in production by various tech companies and open source organizations.
 
 {{% /blocks/feature %}}
 
-{{% blocks/feature icon="fa-brands fa-github" title="Contribute" url="https://github.com/theupdateframework" %}}
-Start contributing to TUF open source by creating a Pull request on
-[GitHub](https://github.com/theupdateframework)
+{{% blocks/feature icon="fa-brands fa-github" title="Contribute" url="/docs/contributing" %}}
+Get involved! Start contributing to TUF.
 
 {{% /blocks/feature %}}
 

content/en/docs/get-started/contributor.md → content/en/docs/contributing.md

@@ -1,7 +1,6 @@
 ---
-title: Contributor
-weight: 17
-description: Learn how to contribute to TUF
+title: Contributing
+weight: 700
 ---
 
 There are many opportunities to contribute to TUF project. You can contribute to
@@ -12,4 +11,4 @@ For guidance on how to contribute, see the
 
 For more information on how to contribute, reach out to the
 [TUF community site](/community/) or check out areas of contribution on GitHub
-[The Update Framework](https://github.com/theupdateframework).
+[The Update Framework]({{% param github_repo %}}).

content/en/docs/getting-started.md

@@ -0,0 +1,44 @@
+---
+title: Getting started
+aliases: [/implementations]
+cSpell:ignore: RSTUF
+weight: 200
+---
+
+TUF provides a framework for integration of the [security](../security/)
+properties into new and existing content delivery systems. This page will help
+you get started if you want to use TUF either as a maintainer or client.
+
+While some [adoptions](/community/adoptions/) integrate TUF by implementing the
+framework from scratch, others start from either a TUF
+[implementation](#implementations) or from a TUF [system](#systems). This page
+lists open source implementations of TUF which can be used as building blocks
+for any TUF adoption.
+
+## Implementations
+
+TUF implementations provide libraries implementing the primitives and
+algorithms, such as the detailed client workflow, in the specification.
+
+- [python-tuf](https://github.com/theupdateframework/python-tuf), the reference
+  implementation
+- [go-tuf](https://github.com/theupdateframework/go-tuf/)
+- [tuf-js](https://github.com/theupdateframework/tuf-js)
+
+## Systems
+
+TUF systems build on top of library implementations and provide opinionated
+signing systems designed for particular use-cases.
+
+- [Repository Service for TUF](https://repository-service-tuf.readthedocs.io/en/stable/)
+  (RSTUF) is a designed to integrate into an existing artifact repository with
+  an established storage and delivery system.
+- [tuf-on-ci](https://github.com/theupdateframework/tuf-on-ci/) is a TUF
+  repository and signing tool designed to operate on a CI system and guide
+  signing events through Git forge workflows.
+
+## Learn more
+
+- Some of our [Videos](/resources/videos/) explain how to implement TUF
+  practically.
+- To learn about how to contribute to TUF, see [Contributing](../contributing).

hugo.yaml

@@ -82,7 +82,7 @@ params:
       TUF Authors | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0) |
       [Funding](/docs/project/funding/) |
     # from_year: 2024
-  github_repo: https://github.com/theupdateframework
+  github_repo: &repo https://github.com/theupdateframework/theupdateframework.io
   gcs_engine_id: 011217106833237091527:la2vtv2emlw # CUSTOMIZE # FIXME get an ID for the starter?
   privacy_policy: https://www.linuxfoundation.org/legal/privacy-policy
   ui:
@@ -120,9 +120,9 @@ params:
         desc: Join our community meetings.
     developer:
       - name: GitHub repository
-        url: https://github.com/theupdateframework/theupdateframework.io
+        url: *repo
         icon: fa-brands fa-github
-        desc: Website repository.
+        desc: Website and documentation repository.
 
 module:
   mounts: