Update Fidesops overview /w video & consistency (#19)

* Documentation updates and video additions * Update Fidesops overview /w video & consistency * Fix merge & update logo comment Co-authored-by: Cillian Kieran <[email protected]>
ethyca · Nov 2, 2021 · 49b0bab · 49b0bab
1 parent 71c07df
commit 49b0bab
Show file tree

Hide file tree

Showing 4 changed files with 45 additions and 12 deletions.
diff --git a/docs/fidesops/docs/css/logo.css b/docs/fidesops/docs/css/logo.css
@@ -0,0 +1,6 @@
+/* -- START: Logo CSS overrides specific to fidesops repo -- */
+
+body header.md-header .md-logo img {
+    width: 120px;
+    height: auto;
+}
diff --git a/docs/fidesops/docs/img/fidesops.svg b/docs/fidesops/docs/img/fidesops.svg
diff --git a/docs/fidesops/docs/index.md b/docs/fidesops/docs/index.md
@@ -2,27 +2,34 @@
 
 Fidesops (fee-dez-äps, combination of the Latin term "Fidēs" + "operations") is an open-source, extensible, deployed engine that fulfills any privacy request (e.g. access request, erasure request) by connecting directly to your disparate databases.
 
-## Programmable Data Privacy
+<iframe width="560" height="315" src="https://www.youtube.com/embed/-BgvyAwXWAc" title="Introduction to Fides Ops with Cillian Kieran" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+## Key Features
+---
+
+### Programmable Data Privacy
 Fidesops connects and orchestrates calls to all of your databases in order to access, update and delete sensitive data per your policy configuration written in [Fideslang](https://github.com/ethyca/privacy-taxonomy).
 
-## DAGs for Datastores
-Fidesops works by integrating all your data store connections into a unified graph - also known as a DAG. We know that sensitive data is stored all around your dynamic ecosystem, so Fidesops builds the DAG at runtime.
+### Handle Dependencies Between Datastores
+Fidesops works by integrating all your datasets into a unified graph and automatically traversing them in order. We know that sensitive data is stored all around your dynamic ecosystem, so Fidesops builds these dependencies automatically for each request.
 
-## B.Y.O. DSAR Automation Provider
-Fidesops handles the integration to your existing privacy management tools like OneTrust to fulfill Data Subject Requests and return the package back to the DSAR Automation provider.
+### Integrate with Compliance Tools
+Fidesops is open & extensible, meaning it can easily be integrated into your existing privacy compliance management tools like OneTrust to fulfill data subject requests and return results, automatically.
 
-## Built to Scale
-Lots of databases? Tons of microservices? Connect as many databases and services as you'd like, and let Fidesops do the heavy lifting (like auth management, failure retry, and error handling).
+### Built to Scale
+Lots of databases? Tons of microservices? Connect as many databases and services as you'd like, and let Fidesops do the heavy lifting.
 
-# How does Fidesops work with Fidesctl and Fideslang?
-In a software organization, the team that writes and delivers software is normally the same team responsible for executing a privacy request when it comes in from customer support or legal because you know where the data lives.  When your organization receives a privacy request, Fideops will automatically fulfill a privacy request per the execution policies your legal and business owners have created by querying your databases directly. 
+## How does Fidesops work with Fidesctl and Fideslang?
+In a software organization, the team that writes and delivers software is normally the same team responsible for executing a privacy request when it comes in from customer support or legal . When your organization receives a privacy request, Fideops will automatically fulfill it per the execution policies your legal and business owners have created by querying your databases directly. 
 
 ![Fidesops business process](img/fides-ops-process.png "Fidesops biz process")
 
 Your policies and database annotations are written in [**Fideslang**](https://github.com/ethyca/privacy-taxonomy): the syntax that describes the attributes of your data and its allowed purposes of use. 
 
-But after identifying what types of data are in your databases using Fideslang, how will your organization know what data is deemed sensitive? And how will your orgnaization prevent inappropriate uses of that data? That's where [**Fidesctl**](https://github.com/ethyca/fides) comes in. 
+But after identifying what types of data are in your databases using Fideslang, how will your organization know what data is deemed sensitive? And how will your orgnaization prevent inappropriate uses of that data? That's where [**Fidesctl**](https://github.com/ethyca/fides) comes in. Fidesctl is a CLI tool that continuously verifies Fideslang database annotations against acceptable use privacy policies.
 
 ![Fides ecosystem](img/fides-ecosystem.png "Fides ecosystem")
 
-Fidesctl is a CLI tool that continuously verifies Fideslang database annotations against acceptable use privacy policies.
+
+## Next Steps
+
+To start automating requests with Fidesops, visit the [Tutorial](tutorial/index.md) for a step-by-step walkthrough!
diff --git a/docs/fidesops/mkdocs.yml b/docs/fidesops/mkdocs.yml
@@ -52,7 +52,7 @@ theme:
         name: Switch to light mode
   name: material
   favicon: img/favicon.ico
-  logo: img/fides-logo.svg
+  logo: img/fidesops.svg
   font:
     text: Source Sans Pro
   features:
@@ -75,5 +75,6 @@ extra_css:
   - https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/styles/default.min.css
   - css/fides.css
   - css/api.css
+  - css/logo.css
 plugins:
   - render_swagger