Rework landing page and add screenshots (StanfordSpezi#44)

# Rework landing page and add screenshots

## ♻️ Current situation & Problem
Currently, SpeziAccount doesn't really follow the [Documentation
Guide](https://swiftpackageindex.com/stanfordspezi/spezi/documentation/spezi/documentation-guide)
for the landing page and also doesn't include screenshots of the most
important views. Screenshots are particularly useful as we might want to
include them in the main Spezi package.


## ⚙️ Release Notes 
* Updated README and DocC landing page
* Include screenshots of the most important views


## 📚 Documentation
--


## ✅ Testing
--

## 📝 Code of Conduct & Contributing Guidelines 

By submitting creating this pull request, you agree to follow our [Code
of
Conduct](https://github.com/StanfordSpezi/.github/blob/main/CODE_OF_CONDUCT.md)
and [Contributing
Guidelines](https://github.com/StanfordSpezi/.github/blob/main/CONTRIBUTING.md):
- [x] I agree to follow the [Code of
Conduct](https://github.com/StanfordSpezi/.github/blob/main/CODE_OF_CONDUCT.md)
and [Contributing
Guidelines](https://github.com/StanfordSpezi/.github/blob/main/CONTRIBUTING.md).

README.md

@@ -16,25 +16,56 @@ SPDX-License-Identifier: MIT
 [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FStanfordSpezi%2FSpeziAccount%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/StanfordSpezi/SpeziAccount)
 [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FStanfordSpezi%2FSpeziAccount%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/StanfordSpezi/SpeziAccount)
 
-The Account module provides account-related functionality for Spezi-based applications.
-It provides two standardized views with Account Setup, Overview and Edit functionality.
-It allows integrating arbitrary account management services using the Account Service abstraction.
+A Spezi framework that provides account-related functionality including login, sign up and password reset.
+
+## Overview
+
+The `SpeziAccount` framework fully abstracts setup and management of user account functionality for the
+[Spezi](https://github.com/StanfordSpezi/Spezi/) framework ecosystem.
+
+|![Screenshot displaying the account setup view with an email and password prompt and a Sign In with Apple button.](Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountSetup.png#gh-light-mode-only) ![Screenshot displaying the account setup view with an email and password prompt and a Sign In with Apple button.](Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountSetup~dark.png#gh-dark-mode-only)|![Screenshot displaying the Signup Form for Account setup.](Sources/SpeziAccount/SpeziAccount.docc/Resources/SignupForm.png#gh-light-mode-only) ![Screenshot displaying the Signup Form for Account setup.](Sources/SpeziAccount/SpeziAccount.docc/Resources/SignupForm~dark.png#gh-dark-mode-only)|![Screenshot displaying the Account Overview.](Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountOverview.png#gh-light-mode-only) ![Screenshot displaying the Account Overview.](Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountOverview~dark.png#gh-dark-mode-only)|
+|:--:|:--:|:--:|
+|The [`AccountSetup`](https://swiftpackageindex.com/stanfordspezi/speziaccount/documentation/speziaccount/accountsetup) is the central view for account onboarding, facilitating account login and creation. |The [`SignupForm`](https://swiftpackageindex.com/stanfordspezi/speziaccount/documentation/speziaccount/signupform) is used by email-password-based AccountServices by default. |The [`AccountOverview`](https://swiftpackageindex.com/stanfordspezi/speziaccount/documentation/speziaccount/accountoverview) is used to view and modify the user details of the currently associated account.|
+
+
+The ``AccountSetup`` and ``AccountOverview`` views are central to `SpeziAccount`.
+You use the ``AccountDetails`` abstraction within your views to visualize account information of the associated user account.
+
+An ``AccountService`` provides an abstraction layer for managing different types of account management services
+(e.g., email address and password-based service combined with an identity provider like Sign in with Apple).
 
 For more information, please refer to the [API documentation](https://swiftpackageindex.com/StanfordSpezi/SpeziAccount/documentation).
 
+> [!NOTE]
+> The [SpeziFirebase](https://github.com/StanfordSpezi/SpeziFirebase)
+framework provides the [`FirebaseAccountConfiguration`](https://swiftpackageindex.com/stanfordspezi/spezifirebase/documentation/spezifirebaseaccount/firebaseaccountconfiguration)
+you can use to configure an Account Service base on the Google Firebase service.
 
-## The Spezi Template Application
+
+## Setup
+
+You need to add the Spezi Account Swift package to
+[your app in Xcode](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app#) or
+[Swift package](https://developer.apple.com/documentation/xcode/creating-a-standalone-swift-package-with-xcode#Add-a-dependency-on-another-Swift-package).
+
+> [!IMPORTANT]  
+> If your application is not yet configured to use Spezi, follow the [Spezi setup article](https://swiftpackageindex.com/stanfordspezi/spezi/documentation/spezi/initial-setup) to set up the core Spezi infrastructure.
+
+The [Initial Setup](https://swiftpackageindex.com/stanfordspezi/speziaccount/documentation/speziaccount/initial-setup)
+article provides a quick-start guide to set up `SpeziAccount` in your App.
+Refer to the
+[Creating your own Account Service](https://swiftpackageindex.com/stanfordspezi/speziaccount/documentation/speziaccount/creating-your-own-account-service)
+article if you plan on implementing your own Account Service.
 
 The [Spezi Template Application](https://github.com/StanfordSpezi/SpeziTemplateApplication) provides a great starting point and example using the Spezi Account module.
 
 ## Contributing
 
 Contributions to this project are welcome. Please make sure to read the [contribution guidelines](https://github.com/StanfordSpezi/.github/blob/main/CONTRIBUTING.md) and the [contributor covenant code of conduct](https://github.com/StanfordSpezi/.github/blob/main/CODE_OF_CONDUCT.md) first.
 
-
 ## License
 
 This project is licensed under the MIT License. See [Licenses](https://github.com/StanfordSpezi/SpeziAccount/tree/main/LICENSES) for more information.
 
-![Spezi Footer](https://raw.githubusercontent.com/StanfordSpezi/.github/main/assets/FooterLight.png#gh-light-mode-only)
-![Spezi Footer](https://raw.githubusercontent.com/StanfordSpezi/.github/main/assets/FooterDark.png#gh-dark-mode-only)
+![Spezi Footer](https://raw.githubusercontent.com/StanfordSpezi/.github/main/assets/Footer.png#gh-light-mode-only)
+![Spezi Footer](https://raw.githubusercontent.com/StanfordSpezi/.github/main/assets/Footer~dark.png#gh-dark-mode-only)

Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountEdit.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Stanford Spezi open-source project
+
+SPDX-FileCopyrightText: 2023 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountEdit~dark.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Stanford Spezi open-source project
+
+SPDX-FileCopyrightText: 2023 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountOverview.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Stanford Spezi open-source project
+
+SPDX-FileCopyrightText: 2023 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountOverview~dark.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Stanford Spezi open-source project
+
+SPDX-FileCopyrightText: 2023 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountSetup.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Stanford Spezi open-source project
+
+SPDX-FileCopyrightText: 2023 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

Sources/SpeziAccount/SpeziAccount.docc/Resources/AccountSetup~dark.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Stanford Spezi open-source project
+
+SPDX-FileCopyrightText: 2023 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

Sources/SpeziAccount/SpeziAccount.docc/Resources/SignupForm.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Stanford Spezi open-source project
+
+SPDX-FileCopyrightText: 2023 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

Sources/SpeziAccount/SpeziAccount.docc/Resources/SignupForm~dark.png.license

@@ -0,0 +1,5 @@
+This source file is part of the Stanford Spezi open-source project
+
+SPDX-FileCopyrightText: 2023 Stanford University and the project authors (see CONTRIBUTORS.md)
+
+SPDX-License-Identifier: MIT

Sources/SpeziAccount/SpeziAccount.docc/SpeziAccount.md

@@ -15,18 +15,47 @@ SPDX-License-Identifier: MIT
 ## Overview
 
 The `SpeziAccount` framework fully abstracts setup and management of user account functionality for the
-[Spezi](https://swiftpackageindex.com/stanfordspezi/spezi/documentation/spezi) framework ecosystem.
-
-> Note: The <doc:Initial-Setup> article provides a quick-start guide to set up `SpeziAccount` in your App.
+[Spezi](https://github.com/StanfordSpezi/Spezi/) framework ecosystem.
+
+@Row {
+    @Column {
+        @Image(source: "AccountSetup", alt: "Screenshot displaying the account setup view with an email and password prompt and a Sign In with Apple button.") {
+            The ``AccountSetup`` is the central view for account onboarding, facilitating account login and creation.
+        }
+    }
+    @Column {
+        @Image(source: "SignupForm", alt: "Screenshot displaying the Signup Form for Account setup.") {
+            The ``SignupForm`` is used by email-password-based AccountServices by default.
+        }
+    }
+    @Column {
+        @Image(source: "AccountOverview", alt: "Screenshot displaying the Account Overview.") {
+            The ``AccountOverview`` is used to view and modify the user details of the currently associated account. 
+        }
+    }
+}
 
 The ``AccountSetup`` and ``AccountOverview`` views are central to `SpeziAccount`.
 You use the ``AccountDetails`` abstraction within your views to visualize account information of the associated user account.
 
 An ``AccountService`` provides an abstraction layer for managing different types of account management services
 (e.g., email address and password-based service combined with an identity provider like Sign in with Apple).
 
-> Note: The [SpeziFirebase](https://swiftpackageindex.com/StanfordSpezi/SpeziFirebase/documentation/spezifirebaseaccount)
-    framework provides the `FirebaseAccountConfiguration` you can use to configure an Account Service base on the Google Firebase service.
+> Note: The [SpeziFirebase](https://github.com/StanfordSpezi/SpeziFirebase)
+framework provides the [`FirebaseAccountConfiguration`](https://swiftpackageindex.com/stanfordspezi/spezifirebase/documentation/spezifirebaseaccount/firebaseaccountconfiguration)
+you can use to configure an Account Service base on the Google Firebase service.
+
+## Setup
+
+You need to add the Spezi Account Swift package to
+[your app in Xcode](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app#) or
+[Swift package](https://developer.apple.com/documentation/xcode/creating-a-standalone-swift-package-with-xcode#Add-a-dependency-on-another-Swift-package).
+
+> Important: If your application is not yet configured to use Spezi, follow the [Spezi setup article](https://swiftpackageindex.com/stanfordspezi/spezi/documentation/spezi/initial-setup) to set up the core Spezi infrastructure.
+
+The <doc:Initial-Setup> article provides a quick-start guide to set up `SpeziAccount` in your App.
+
+Refer to the <doc:Creating-your-own-Account-Service> article if you plan on implementing your own Account Service.
 
 
 ## Topics