# TEA Platform Tutorial videos

:::info
🙆 Structuring a few tutorial videos for the TEA platform, broken down into digestible, focused sessions that cater to specific features or user actions. This approach makes it easy for users to find the information they need and follow along at their own pace.
:::

### Video 1: Introduction to the TEA Platform
**Content:** An overview of the TEA platform, highlighting its purpose, key features, and the value it brings to various stakeholders.
**Visuals:** High-level diagrams or animations explaining the concept of assurance cases, supported by quick navigational tours of the platform interface.

> **Introduction:**
>
> [Opening shot of the TEA platform's homepage, with upbeat background music playing softly]
>
> *Narrator:* "Welcome to the Trustworthy and Ethical Assurance, or TEA, platform tutorial series! Today, we're exploring the newly updated login screen and user dashboard. This video will guide you through the sign-up process, log in, and give you a tour of the dashboard's key features. Let's get started."
>
> [Transition to the new login screen]
>
> **Body:**
>
> [Show the login screen]
>
> *Narrator*: "The first thing you'll notice is our sleek, redesigned login screen. Signing up or logging in has never been easier."
>
> [Highlight the 'Sign Up' and 'Log In' buttons with on-screen text]
>
> *Narrator*: "If you're new here, click 'Sign Up' to create your account with just a username and a password."
>
> [Cut to the sign-up form, enter dummy details, and click 'Sign Up']
>
> *Narrator*: "Existing users can simply log in with their credentials. Notice the top menu bar - it offers quick access to our GitHub repository, allowing you to directly engage with the development community or access the platform's code and documentation."
>
> [Show cursor moving to click on the GitHub link, then cut back to the dashboard]
>
> *Narrator*: "Once logged in, you're greeted by the dashboard. Here's where the magic happens."
>
> [Show the 'Create a new case' button, with a highlight]
>
> *Narrator*: "The prominent 'Create a new case' button is your starting point for new assurance cases. On the left, easy access to documentation and methodology info aids your journey."
>
> [Click on 'Create a new case', showing the dialog]
>
> *Narrator*: "Let's quickly touch on importing existing assurance cases. Look for this option in the upper right corner."
>
> [Show the import button and click it, then show file and URL import options]
>
> *Narrator*: "You can import cases as SVG or JSON files, or even via a URL, making it simple to integrate your existing work into the TEA platform."
>
> [Transition back to the dashboard]
>
> **Conclusion:**
>
> [Recap with key dashboard features shown on-screen]
>
> *Narrator*: "And there you have it! You're now familiar with the TEA platform's new login screen and dashboard, designed to make your experience as smooth and productive as possible. Explore, create, and import assurance cases with ease."
>
> [Show a slide with titles of other tutorial videos in the series]
>
> *Narrator*: "Don't stop here - check out our other tutorials to dive deeper into creating assurance cases, managing your projects, and leveraging the platform's full potential. Thank you for watching, and happy assuring!"
>
> [End with the TEA platform logo and website URL]

### Video 2: Getting Started: Login and Sign-Up
**Content:** Detailed walkthroughs of the new login screen and sign-up dialog, including navigating the top menu bar for access to the GitHub repository, opening issues, and accessing documentation.
**Visuals:** Step-by-step screen captures showing the login process, sign-up form completion, and where to find helpful links.

> **Introduction:**
>
> [TEA Platform logo, then transition to the dashboard interface.]
>
> *Narrator*: "Welcome to the second tutorial in our TEA Platform video series! Today, we'll explore the User Dashboard, your central hub for navigating the platform, creating new assurance cases, and accessing vital resources. Let's dive in to make the most of your TEA experience."
>
> **Body:**
>
> [Graphics: Show the dashboard screen with the "Create a new case" button highlighted. On-screen Text: "Dashboard Overview"]
> *Narrator*: "Upon logging in, you're greeted by the Dashboard. It's designed with clarity and ease of use in mind."
>
> [Graphics: Cursor clicking the "Create a new case" button, transitioning to the case creation screen. On-screen Text: "Starting Your Assurance Case"]
>
> *Narrator*: "The 'Create a new case' button is your starting point for new projects. Clicking this button initiates the process."
>
> [Highlight the documentation link and show a preview of the documentation pages. On-screen Text: "Documentation & Methodology Resources"]
>
> *Narrator*: "On the left, you'll find quick access to platform documentation. This includes guides on assurance methodology, helping you craft more effective cases."
>
> *Tip*: "Tip: Reviewing the documentation can provide valuable insights into creating comprehensive assurance cases."
>
> [Graphics: Show the import button and simulate importing a file, including the selection of a file and the successful import notification. On-screen Text: "Importing Existing Assurance Cases"]
>
> *Narrator*: "Looking to import an existing case? Use the import feature in the upper right corner to upload SVG or JSON files, streamlining your workflow."
>
> [Graphics: Teaser graphic or placeholder for upcoming tutorial cases. On-screen Text: "Coming Soon: Interactive Tutorials"]
>
> *Narrator*: "For those new to the platform, interactive tutorial cases will soon be available, offering guided learning to familiarize you with all features."
>
> ==Could also fit something here with templates instead of interactive tutorials==
>
> **Conclusion:**
>
> [Graphics: Recap of the dashboard features with soft background music, ending on the TEA Platform logo.
Suggest Next Video: "Next, learn about the Assurance Case Import and Creation process in Video 3 of our series."]
>
> *Narrator*: "The User Dashboard is your gateway to leveraging the TEA Platform effectively. From creating new assurance cases to accessing a wealth of resources, it's designed to enhance your experience and streamline your projects. For more detailed guides on specific features, check out our other tutorial videos."

### Video 3: Navigating Your User Dashboard
**Content:** An exploration of the user dashboard's features, including creating a new case, accessing documentation, and importing existing assurance cases.
**Visuals:** Direct demonstrations of using the dashboard, highlighting the "Create a new case" button and the import functionality.

> **Introduction:**
>
> [Opening shot of the TEA platform's user dashboard, with a smooth, engaging background tune. The dashboard's clean interface is front and center.]
>
> *Narrator*: "Welcome back to our tutorial series on the Trustworthy and Ethical Assurance, or TEA, platform. In this video, we'll dive into your user dashboard, where your journey in creating, managing, and importing assurance cases begins. Whether you're new to the platform or looking for a refresher, you'll find valuable insights on how to navigate and utilize the dashboard effectively. Let's jump in."
>
> [Transition to the dashboard's overview]
>
> **Body:**
>
> [Screen capture starts with a cursor hovering over the "Create a new case" button.]
>
> *Narrator*: "At the heart of your dashboard is the 'Create a new case' button. Clicking here is your first step toward building an assurance case from scratch."
>
> [Cursor clicks the button, showing a simple form. On-screen text highlights: "Title" and "Description."]
>
> *Narrator*: "Enter a title and a brief description of your case. These details are essential for clarity and collaboration within your team."
>
> [Transition to the documentation access area on the left-hand side. Highlight this section with a bright frame or arrow.]
>
> *Narrator*: "Looking for guidance? The left-hand side gives you quick access to the platform's comprehensive documentation and methodology. It's a treasure trove of information to get the most out of your assurance cases."
>
> [Shifts to the import feature, with an arrow pointing to the "Import existing case" button.]
>
> *Narrator*: "Already have work you want to bring over? The import feature supports SVG or JSON files. Just click here, and follow the prompts to upload your file or enter a URL to a publicly accessible case."
>
> [Demonstration of importing a case via URL, with on-screen text emphasizing "Paste URL here."]
>
> *Narrator*: "Paste the URL to your SVG or JSON file, and watch as your existing case becomes part of the TEA platform, ready for further development or sharing."
>
> **Conclusion:**
>
> [Summarizing shot of the dashboard, slowly zooming out.]
>
> *Narrator*: "And that wraps up our tour of the TEA platform's user dashboard. With these features at your fingertips, you're well-equipped to start or continue your assurance case projects with ease. Don't forget to explore our other videos, like how to create a new assurance case or delve into the assurance case builder for more advanced functionalities."
>
> [Fade out with the TEA platform's URL and a "Learn More" call-to-action on the screen.]
>
> *Narrator*: "Thank you for watching. Visit our documentation for more in-depth guides, and stay tuned for more tutorials to enhance your TEA platform experience. Happy assuring!"
>
> [End with upbeat outro music fading with the video.]

### Video 4: Creating and Importing Assurance Cases
**Content:** Instructions on how to create a new assurance case using both the "Empty case" and "Minimal template" options, and how to import cases using file uploads and URLs.
**Visuals:** Detailed demonstrations of each method of creating or importing cases, focusing on the dialog options and the process for each method.

> **Introduction:**
>
> [Opening shot of the TEA platform's dashboard, with a focus on the "Create a new case" button, accompanied by light, encouraging background music]
>
> *Narrator*: "Hello and welcome back to our TEA platform tutorial series. In this video, we'll dive into how to kickstart your assurance case journey by creating a new assurance case and importing existing ones. Whether you're starting from scratch or leveraging past work, we've got you covered. Let's embark on this journey together."
>
> [Cut to the "Create a new case" button on the dashboard]
>
> **Body:**
>
> [Screen capture starts with the narrator clicking the "Create a new case" button]
>
> *Narrator*: "Creating a new assurance case is the first step in documenting the trustworthiness of your technology. Let's click on the 'Create a new case' button to see our options."
>
> [A cursor hovers over the "Empty case" and "Minimal template" options, emphasizing each]
>
> *Narrator*: "You have two paths here: starting with an 'Empty case' for full freedom or using a 'Minimal template' to get a head start with a basic structure. Let's explore both."
>
> [The process of selecting and filling in details for an "Empty case" is shown]
>
> *Narrator*: "Choosing 'Empty case' presents you with a blank canvas, ideal for those who prefer to structure their assurance case from the ground up."
>
> [Transition to the "Minimal template", showing the pre-populated elements]
>
> *Narrator*: "Opting for the 'Minimal template' provides you with a foundational setup. It’s perfect for quickly diving into the assurance process with less initial setup."
>
> [Shift focus to importing cases, showing the "Import" button]
>
> *Narrator*: "If you already have assurance cases, you can easily import them using the import feature. The platform supports both SVG and JSON formats."
>
> [A demonstration of importing a file, followed by pasting a URL for import]
>
> *Narrator*: "You can upload a file directly or use a publicly accessible URL. Both methods are straightforward and ensure your previous work is seamlessly integrated into the TEA platform."
>
> [Highlight the documentation and links for guidance on file conventions]
>
> *Narrator*: "For detailed conventions on SVG or JSON files, refer to our comprehensive documentation accessible from the dashboard."
>
> **Conclusion:**
>
> [Closing shot of an assurance case being successfully created and imported, with the dashboard in view]
>
> *Narrator*: "And there you have it! Whether you're crafting a new assurance case or bringing in existing ones, the TEA platform is designed to make the process as smooth as possible. Don't forget to explore our documentation for more tips and tricks. Stay tuned for more tutorials to help you navigate the TEA platform with ease."
>
> [On-screen text: "Next Video: Navigating the Assurance Case Builder"]
>
> *Narrator*: "Up next, we'll take a closer look at the Assurance Case Builder. Thank you for watching, and see you in the next video!"
>
> [End of video with a soft fade-out of the background music]

### Video 5: The Assurance Case Builder in Action
**Content:** A comprehensive guide on using the Assurance Case Builder, including adding goals, contexts, claims, strategies, and evidence.
**Visuals:** A walkthrough of the Assurance Case Builder interface, showing how to add and edit various elements, with examples of filling in details for goals, contexts, and more.

> **Introduction:**
>
> [Opening shot transitions from the TEA platform's homepage to the Assurance Case Builder interface, with soft, encouraging background music.]
>
> *Narrator*: "Welcome back to our TEA platform tutorial series. In this episode, we dive into the heart of the platform—the Assurance Case Builder. Whether you're building your first assurance case or refining an existing one, this video will guide you through adding goals, contexts, claims, strategies, and evidence. Ready to see how it all comes together? Let's jump right in."
>
> **Body:**
>
> [Screen capture shows the Assurance Case Builder interface, highlighting the "Create a new case" button.]
>
> *Narrator*: "Starting with a blank canvas, the first step in the Assurance Case Builder is to add a goal. This is the cornerstone of your assurance case."
>
> [Shows cursor clicking on "Add Goal," then typing in a goal name and description.]
>
> *Narrator*: "Next, let's add context to our goal, providing background information that frames our case."
>
> [Cursor moves to add a context, with on-screen text highlighting the fields being filled.]
>
> *Narrator*: "With our goal and context set, we'll now add a claim. Claims support your goal and require evidence to back them up."
>
> [Visual transition to adding a claim, showing how to input details.]
>
> *Narrator*: "Strategies outline how your claims support the goal. Let's add one now."
>
> [Screen capture demonstrating adding a strategy, with emphasis on the strategy's role in the case.]
>
> *Narrator*: "Lastly, evidence is crucial. It provides the foundation for your claims. Here's how to attach evidence to your case."
>
> [Shows process of adding evidence, highlighting the option to link to external URLs or upload files.]
>
> [Throughout the body, on-screen text and highlights draw attention to important areas, buttons, and fields. Tips pop up, such as "Remember to save frequently" and "Use descriptive names for easy navigation."]
>
> **Conclusion:**
>
> [Screen transitions back to the Assurance Case Builder's overview with a fully structured case visible.]
>
> *Narrator*: "And that's a wrap on using the Assurance Case Builder within the TEA platform. You've seen how to start from scratch and systematically build up your assurance case with goals, contexts, claims, strategies, and evidence. Explore, experiment, and see what you can create."
>
> [On-screen text suggests the next video in the series: "Next: Managing and Sharing Your Assurance Cases."]
>
> *Narrator*: "Stay tuned for more tutorials, including how to manage and share your cases for collaborative development. Thank you for watching, and happy building!"
>
> [The video ends with the TEA platform logo and a reminder to visit the documentation for more detailed guides. Soft background music fades out.]

### Video 6: Advanced Features: Collaborating and Managing Cases
**Content:** An overview of advanced features like the case management menu, accessibility options, exporting cases, adding collaborative notes, setting permissions, and deleting cases.
**Visuals:** Screen captures showing how to access and use each feature, with examples of adjusting settings, exporting a case, and using the notes and permissions functions.

> **Introduction:**
>
> [The video starts with an animated graphic of the TEA platform's homepage, while gentle, uplifting music plays in the background.]
>
> *Narrator*: "Hello and welcome back to our TEA platform tutorial series! In this session, we'll dive into the advanced features that make collaborating on and managing your assurance cases a breeze. From the case management menu to setting permissions and exporting cases, we'll cover all you need to know to efficiently work within the TEA platform. Ready to level up your assurance case management skills? Let's jump right in!"
>
> [Cut to the dashboard of the TEA platform, highlighting the case management menu.]
>
> **Body:**
>
> [The video transitions to a screen capture of the dashboard, with the narrator guiding the viewer.]
>
> *Narrator*: "First, let's explore the case management menu, located right next to your assurance case name. This handy drop-down menu offers quick access to several powerful features."
>
> [On-screen highlight and click on the case management menu, showing each option sequentially.]
>
> *Narrator*: "Looking to make your assurance case more accessible? Check out the Accessibility options, where you can adjust the colour scheme to suit your needs or those of your team."
>
> [Showcase changing the colour schemes, demonstrating the effect on the interface.]
>
> *Narrator*: "Exporting your case for sharing or backup is straightforward. Simply select 'Export' and choose between JSON and SVG formats. Remember, SVG files include your case's data in the metadata, making re-imports effortless."
>
> [Visual demonstration of exporting a case, with on-screen text highlighting the file format options.]
>
> *Narrator*: "Collaboration is key, and the Notes feature facilitates this beautifully. Add timestamped comments visible to all case contributors, encouraging productive discussions right within the platform."
>
> [Show adding a comment to a case, with emphasis on the collaborative aspect.]
>
> *Narrator*: "Setting permissions is crucial for managing access to your assurance case. The Permissions dialog lets you share cases with specific users or groups, ensuring the right people have the appropriate level of access."
>
> [Display the permissions setting process, highlighting different access levels.]
>
> *Narrator*: "Lastly, if you need to delete a case, the platform ensures you're making an informed decision with a confirmation dialog. It's a safeguard against accidental deletions, keeping your work secure."
>
> [Show the deletion process, focusing on the confirmation dialog.]
>
> **Conclusion:**
>
> [The video concludes with a summary of the features discussed, accompanied by a gentle reminder of the importance of collaboration and management in assurance case development.]
>
> *Narrator*: "And that wraps up our exploration of the TEA platform's advanced features for collaborating and managing assurance cases. From customising accessibility settings to securely sharing and managing your cases, these tools are designed to enhance your experience and productivity. Don't forget to check out our other tutorials for more tips on making the most of the TEA platform. Thank you for watching, and see you in the next video!"
>
> [The video fades out with the TEA platform's logo and a link to the next tutorial in the series.]