add api.md and auth.md; rename clowder section

Signed-off-by: Avi Deitcher <avi@deitcher.net>

Author: deitch

docs/ainekko/index.md

@@ -1,11 +1,9 @@
 ---
-id: what-is-ainekko
-title: What Is Ainekko?
+id: who-is-ainekko
+title: Who Is Ainekko?
 sidebar_position: 1
 ---
 
-What is Ainekko?
-
 Ainekko is a leading AI hardware and software provider.
 
 Ainekko is the leading sponsor of [Clowder](/docs/clowder).

docs/clowder/api.md

@@ -0,0 +1,32 @@
+---
+id: clowder-api
+title: Clowder API
+sidebar_position: 9
+---
+
+Clowder provides a RESTful API for interacting with the platform. The API allows you to manage models, deployments, and configurations, as well as perform inference on deployed models.
+
+There are two distinct categories of API endpoints:
+
+* Inference
+* Operational
+
+## Inference API
+
+The inference API is used to interact with deployed models and perform inference. It allows you to send queries to models and receive responses.
+
+The inference API is compatible with the [OpenAI API](https://platform.openai.com/docs/api-reference/introduction) and supports the same endpoints and parameters. It also augments it with additional endpoints for usage with Clowder.
+
+Inference API endpoints are used by end-users directly or by AI applications to interact with deployed models.
+
+Read the official Clowder Inference API documentation for all of the endpoints.
+
+## Operational API
+
+The operational API is used to manage models, deployments, and configurations. It allows you to create, update, and delete models, deployments, and configurations, as well as retrieve information about them.
+
+Operational API endpoints are used by administrators and developers to manage the Clowder platform.
+
+Read the official Clowder Operational API documentation for all of the endpoints.
+
+

docs/clowder/authentication.md

@@ -0,0 +1,11 @@
+---
+id: clowder-auth
+title: Clowder Authentication
+sidebar_position: 10
+---
+
+Requests to the Clowder API require authentication, in the form of a Bearer token.
+
+As of this writing, the Bearer token is a static token, configured when you deploy Clowder. By default, it is `nekko-admin-token`.
+
+Clowder is building support for multiple forms of authentication.

docs/clowder/web.md

@@ -0,0 +1,23 @@
+---
+id: clowder-web
+title: Clowder Web UI
+sidebar_position: 8
+---
+Clowder is a system for deploying, managing, and operating AI models.
+As such, its focus is on the backend of managing models, configurations, and deployments, and providing APIs for interacting with these models.
+These APIs usually are integrated into other systems, such as web applications or command-line interfaces (CLIs), rather than
+serving as a standalone user interface.
+
+However, by default, Clowder does include the Open WebUI client app, a web-based user interface (UI) that allows users to interact with models.
+
+The Open WebUI is exposed at port 4080 of the service `open-webui` in the `clowder` namespace.
+
+You can expose it locally with:
+
+```sh
+# Start this and leave it running in a separate terminal window.
+kubectl port-forward svc/open-webui 4080:4080
+```
+
+Whether exposed locally or accessed directly in the cluster, open it in your browser, for example locally at [http://localhost:4080](http://localhost:4080).
+Open a browser to the address, select the model, and have a chat.

docusaurus.config.js

@@ -82,13 +82,13 @@ const config = {
             type: 'docSidebar',
             sidebarId: 'structureSidebar',
             position: 'left',
-            label: 'What is Clowder?',
+            label: 'Clowder Docs',
           },
           {
             type: 'docSidebar',
             sidebarId: 'guideSidebar',
             position: 'left',
-            label: 'What is Ainekko?',
+            label: 'Who is Ainekko?',
           },
           {
             type: 'docSidebar',
@@ -110,8 +110,8 @@ const config = {
           {
             title: 'Docs',
             items: [
-              { label: 'What is Clowder?', to: '/docs/clowder' },
-              { label: 'What is Ainekko?', to: '/docs/ainekko' },
+              { label: 'Clowder Docs', to: '/docs/clowder' },
+              { label: 'Who is Ainekko?', to: '/docs/ainekko' },
               { label: 'Community', to: '/docs/community' },
             ],
           },