Update oauth.md

articles/getting-started/permissions-overview.md

@@ -0,0 +1,36 @@
+# Permissions & Governance Overview 
+
+## Organizations 
+
+| **Organization Actions**        | **Guest** | **Member** | **Administrator** | **Owner** |
+|---------------------------------|:-----------:|:------------:|:-------------------:|:-----------:|
+| Read Public Projects            |     X     |      X     |         X         |     X     |
+| View Organization Collaborators |           |      X     |         X         |     X     |
+| View Organization Teams         |           |      X     |         X         |     X     |
+| Create Projects                 |           |      X     |         X         |     X     |
+| Read Private Projects           |           |      X     |         X         |     X     |
+| Write Projects                  |           |            |         X         |     X     |
+| Manage Collaborators            |           |            |         X         |     X     |
+| Manage Teams                    |           |            |         X         |     X     |
+| Manage Organization Settings    |           |            |                   |     X     |
+| Manage Organization Billing     |           |            |                   |     X     |
+| Delete Organization             |           |            |                   |     X     |
+
+## Teams 
+
+|      **Team Actions**     | **Member** | **Administrator** | **Owner** |
+|-------------------------|:------------:|:-------------------:|:-----------:|
+| View Team Collaborators   | X          | X                 | X         |
+| Add Team to Projects      | X          | X                 | X         |
+| Manage Team Collaborators |            | X                 | X         |
+| Manage Team Settings      |            | X                 | X         |
+| Delete Team               |            |                   | X         |
+
+## Projects 
+
+| **Project Actions**          | **Read** | **Write** | **Administrator** |
+|------------------------------|:--------:|:---------:|:-----------------:|
+| Read Project                 | X        | X         | X                 |
+| Write Project                |          | X         | X                 |
+| Manage Project Collaborators |          |           | X                 |
+| Delete Project               |          |           | X                 |

articles/hubs/custom-css.md

@@ -1,17 +1,11 @@
 # Custom CSS
 
-![Applying Custom CSS](https://github.com/stoplightio/docs/blob/develop/assets/gifs/hubs-custom-css.gif?raw=true)
-
-## What 
-
-Want to add some style and flair to your documentation? Add your own custom CSS to enhance your Hub’s look and feel. Below are some of the classes you can modify: 
-
 ```
 .Hub
   .HubHeader
     .HubHeader-section
       .HubHeaderItem.is-active
-        .HubHeaderItem-name
+        .HubHeaderItem-name 
   .HubMain
     .HubSidebar-overlay
     .HubSidebar-wrapper
@@ -23,24 +17,7 @@ Want to add some style and flair to your documentation? Add your own custom CSS
         .HubPage-inner
           .HubPage-content
             .HubPageCrumbs
-              .HubPageCrumb 
-            .HubPageBody 
-              .HubBlock
+              .HubPageCrumb
+            .HubPageBody
             .HubPageFooter
 ```
-
-## How
-
-1. Select the Hub you wish to modify 
-2. Select the **Design View**
-3. Click on **Theme** in the top toolbar 
-4. Select **Custom CSS** in the bottom left 
-5. Input CSS in the text area at the bottom of the page 
-6. Input CSS in the generated **theme** file (optional)
-7. In publishing, check the **Custom CSS** box under **Advanced** to apply the Custom CSS to that Hub when published
-
->After accessing Custom CSS, a **theme** file will be generated under Documentation in the file explorer. After making changes to your CSS, make sure to save the **theme** file. 
-
----
-**Related Articles**
-- [Theming](/documentation/design/theming)

articles/hubs/oauth.md

@@ -0,0 +1,56 @@
+# OAuth for Hubs 
+
+## What 
+
+OAuth provides a level of security to your documentation to restrict access to it. Enabling OAuth in Hubs can be accomplished through two different methods: via Modeling or directly into the Hubs code.
+
+> Stoplight supports OAuth 1.0 and 2.0 
+
+## How 
+
+### Modeling 
+
+![OAuth in Modeling](https://github.com/stoplightio/docs/blob/develop/assets/images/hubs-oauth-modeling.png?raw=true)
+
+1. Create a new Modeling file or select an existing one referenced by the Hub you wish to modify 
+
+> If you are creating a new Modeling file, make sure to reference it in your Hub 
+
+2. Next to **Security** in the left-middle toolbar, Add a Security Scheme by clicking the **+**
+3. Input a **key**
+4. Select oauth2 under **type** 
+5. Select **accessCode** under OAuth **flow** 
+6. Select an **authorization url**
+7. Select a **token url** 
+8. **Add Scope** (optional) 
+9. Add a **Security scheme description** (optional)
+
+### Hubs 
+
+![OAuth in Hubs](https://github.com/stoplightio/docs/blob/develop/assets/images/hubs-oauth-code.png?raw=true)
+
+1. Select the Hub you wish to modify 
+2. Select **Code View**
+3. Add the following lines of code to your Hub:
+
+```
+
+"config": {
+  "http": {
+    "oauth2": {
+      "credentials": {
+        "authorize_url": "insert authorize url here",
+        "access_token_url": "insert access token url here",
+      }
+    }
+  }
+}
+
+```
+
+---
+**Related Articles**
+
+- [Digital Oceans: Introduction to OAuth2](https://www.digitalocean.com/community/tutorials/an-introduction-to-oauth-2)
+- [Security Schemes](/modeling/modeling-with-openapi/security-schemes)
+