Add better documentation

Signed-off-by: David Weik <[email protected]>

Author: Criptic

package-lock.json

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

static/sas.png

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+### Installation
+
+```
+$ yarn
+```
+
+### Local Development
+
+```
+$ yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```
+$ yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+### Deployment
+
+Using SSH:
+
+```
+$ USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```
+$ GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

website/.gitignore

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve("@docusaurus/core/lib/babel/preset")],
+};

website/README.md

@@ -0,0 +1,18 @@
+---
+sidebar_position: 7
+---
+
+# Client Administrator
+
+The Client Administrator object enables you to view, edit, create and delete REST applications registered with SAS Viya. Please note that for most of the utilities that this tool provides *SAS Administrator* group member ship is required.
+
+In order to create a Client Administrator object you have to set the objects type to *clientAdministrator*, there are no additional attributes, but the width has to be 0 - example:
+```json
+{
+    "name": "Display Name",
+    "id": "Object ID",
+    "width": 0,
+    "objectBorder": false,
+    "type": "clientAdministrator",
+}
+```

website/babel.config.js

@@ -0,0 +1,28 @@
+---
+sidebar_position: 5
+---
+
+# Interactive Content
+
+The Interactive Content object enables you to embed interactive content from other websites. This object is primarily meant to include SAS Viya Job Execution Engine Jobs (SAS Jobs), SAS 9.4 Stored Processes (STP) and SAS 9.4 WRS Reports. But you can also include links to other web content here.
+
+In order to create a interactive content object you have to set the objects type to *interactiveContent*, specify link, configure its exception behavior and indicate if it is SAS Viya content - example:
+```json
+{
+    "name": "Display Name",
+    "id": "Object ID",
+    "width": 1,
+    "objectBorder": false,
+    "type": "interactiveContent",
+    "link": "URL",
+    "exception": {
+        "isException": 0,
+        "width": 0,
+        "height": 0
+    },
+    "isViyaContent": true
+}
+```
+- **link**, contains the fully qualified URL (except if it is SAS Viya content, than only use the link relative link to the content) to the content which will be displayed here - the URL can be URL encoded, but it doesn't have to be - recommended is to not use the encoded URL. The link attribute is **required**.
+- **exception**, is used when you want to include a URL that throws a [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS) exception. Such an exception leads to the circumstance that the height and width of the content can not be determined dynamically and thus would default to rather small values. If CORS is not an issue this argument is completely optional - the default value for **isException** is 0, then it is assumed that CORS is not an issue and the width and height are determined based on the content, setting the value to 1 indicates that a CORS exception is expected and the values in the width and height are used as pixel values. The exception attribute is *optional* and should only be used if there is no way to resolve the CORS exception otherwise.
+**isViyaContent**, makes interactive content that you display using this object independent of your SAS Viya environment and rather enables you to tell the SAS Portal to use the SAS Viya host URL used by the Portal itself. If you specify a value of *true* then you will not need to specify the SAS Viya host it will be added for you, just start your link with a / and then relative to your SAS Viya host. If you specify *false* then you have to provide an absolute URL. The isViyaContent attribute is *required*.

website/docs/Objects/client-administrator-object.md

@@ -0,0 +1,28 @@
+---
+sidebar_position: 3
+---
+
+# Link List
+
+The link list object enables you to display an amount of links that are clickable and you can specify if the links should open in a new tab or if the page should be opened on the current page (back navigation is then handled through the browsers back functionality).
+
+In order to create a link list object you have to set the objects type to *linkList*, specify the clickBehavior and specify the links - example:
+```json
+{
+    "name": "Display Name",
+    "id": "Object ID",
+    "width": 1,
+    "objectBorder": false,
+    "type": "linkList",
+    "clickBehavior": "tab",
+    "links": [
+        {
+            "displayText": "Display text",
+            "link": "https://sas.com"
+        }
+    ]
+}
+```
+
+- **clickBehavior**, specify how the user is navigated when clicking a link from the list. The acceptable values are *same* - to open links in the same browser window - and *tab* -  to open up the links in a new browser tab. The clickBehavior attribute is *required*.
+- **links**, takes a list of objects. Each object has two attributes, *displayText* which is the text the user should see and *link* which is the actual URL that opens when clicked. The links attribute is *required*.

website/docs/Objects/interactive-content-object.md

@@ -0,0 +1,18 @@
+---
+sidebar_position: 6
+---
+
+# MAS Module Scorer
+
+The MAS Module Scorer enables you to quickly test and validate your published SAS Intelligent Decisioning decisions and SAS Model Manager models that have been published to MAS (SAS **M**icro **A**nalytic **S**ervice) - link to the (SAS documentation)[https://go.documentation.sas.com/doc/en/mascdc/default/masag/titlepage.htm].
+
+In order to create a MAS Module Scorer object you have to set the objects type to *masScore*, there are no additional attributes, but the width has to be 0 - example:
+```json
+{
+    "name": "Display Name",
+    "id": "Object ID",
+    "width": 0,
+    "objectBorder": false,
+    "type": "masScore",
+}
+```

website/docs/Objects/link-list-object.md

@@ -0,0 +1,40 @@
+---
+sidebar_position: 1
+---
+
+# Introduction to Objects
+
+Objects are the heart and sould of the SAS Portal. Each object type enables different interactions and offers different capabilities. Because of that each object type will have its own page that explains further the specific configuration options that are available for it.
+
+This page explains the attributes that are shared by all object types, so that each object type page can focus only on the additional attributes.
+
+While you can write this objects by hand, you can also use the Portal Builder object, which enables you to build this objects in a visual way directly from within the portal.
+
+## Shared Attributes
+
+Below we take at the shared attributes of all object types:
+```json
+{
+    "name": "Display Name",
+    "id": "Object ID",
+    "width": 1,
+    "height": "700vh",
+    "objectBorder": false,
+    "type": "objectType"
+}
+```
+
+- **name**, specifies the name of the object in the UI and is always added as a heading in the object. The name attribute is *required*.
+- **id**, is a technical attribute that has to be unique within a page and can not contain blanks or special characters. The id attribute is *required*.
+- **width**, specifies how much of the n columns (specified in the general page definition) the object can take up in the UI. The minimum value is 0 and the maximum is 5. The width attribute is *required*. Here is a list of the value break downs:
+    - **"auto"**, let object grow as big as needed by its content
+    - **0**, make the object take up a whole row
+    - **1**, make the object take up 75% of the row
+    - **2**, make the object take up 66% of the row
+    - **3**, make the object take up 50% of the row
+    - **4**, make the object take up 33% of the row
+    - **5**, make the object take up 25% of the row
+
+- **height**, specifies the objects height, this will set the height for the whole row that this object is in. It is required to specify both the value and the unit of measurement - while any valid unit of measurement is acceptable, it is recommended to use vh as it is allows for the most consistent look across devices. Note that if your object is bigger then the allotted space then you will see an additional scrolling bar for that element. The height attribute is *optional*, if no provided the portal will try and figure out an appropriate height.
+- **objectBorder**, enables you to add an optional border around the object. The border color is set to be either the CSS variable value of *--bs-primary* or if that variable is not available it defaults to lightgray. The objectBorder attribute is *optional*, if set to true a border is added to the object.
+- **type**, specifies the type of the object within the UI - that means what content it can contain and display. Please refer to the corresponding page for each types special attributes. The type attribute is *required*.