studio: Add DVC Studio commands to documentation

content/docs/command-reference/studio/index.md

@@ -0,0 +1,37 @@
+# studio
+
+Set of commands to authorize DVC with Studio and save the token to global [DVC
+configuration]: [login](/doc/command-reference/studio/login),
+[logout](/doc/command-reference/studio/logout),
+[token](/doc/command-reference/studio/token),
+
+[dvc configuration]:
+  /doc/user-guide/project-structure/configuration#config-file-locations
+
+## Synopsis
+
+```usage
+usage: dvc studio [-h] [-q | -v] {login,logout,token} ...
+
+positional arguments:
+  {login,logout,token}  Use `dvc studio CMD --help` to display command-specific help.
+    login               Authenticate DVC with Studio host
+    logout              Logout user from Studio
+    token               View the token dvc uses to contact Studio
+
+options:
+  -h, --help            show this help message and exit
+  -q, --quiet           Be quiet.
+  -v, --verbose         Be verbose.
+```
+
+## Description
+
+`dvc studio` authorize dvc with Studio and set the token. When this is set, DVC
+uses this to share live experiments and notify Studio about pushed experiments.
+
+## Options
+
+- `-h`, `--help` - show this help message and exit
+- `-q`, `--quiet` - Be quiet
+- `-v`, `--verbose` - Be verbose

content/docs/command-reference/studio/login.md

@@ -0,0 +1,37 @@
+## studio login
+
+Authorize DVC with Studio to save the token to global [DVC configuration].
+
+[dvc configuration]:
+  /doc/user-guide/project-structure/configuration#config-file-locations
+
+## Synopsis
+
+```usage
+usage: dvc studio login [-h] [-q | -v] [-H <hostname>] [-s <scopes>] [-n <name>] [-d]
+```
+
+## Description
+
+By default, this command authorize dvc with Studio with default scopes and a
+random name as token name.
+
+## Options
+
+- `-h`, `--help` - show this help message and exit
+- `-q`, `--quiet` - Be quiet.
+- `-v`, `--verbose` - Be verbose.
+- `-H <hostname>`, `--hostname <hostname>` - The hostname of the Studio instance
+  to authenticate with.
+- `-s <scopes>`, `--scopes <scopes>` - The scopes for the authentication token.
+- `-n NAME`, `--name <name>` - The name of the authentication token. It will be
+  used to identify token shown in Studio profile.
+- `-d`, `--use-device-code` - Use authentication flow based on user code. You
+  will be presented with user code to enter in browser. DVC will also use this
+  if it cannot launch browser on your behalf.
+
+## Available scopes
+
+- `EXPERIMENTS` - Experiment operations
+- `DATASETS` - Dataset operations
+- `MODELS` - Model registry operations

content/docs/command-reference/studio/logout.md

@@ -0,0 +1,22 @@
+## studio logout
+
+This command helps to log out user from DVC Studio.
+
+## Synopsis
+
+```usage
+usage: dvc studio logout [-h] [-q | -v]
+```
+
+## Description
+
+`dvc logout` removes the studio token stored from global [DVC configuration].
+
+[dvc configuration]:
+  /doc/user-guide/project-structure/configuration#config-file-locations
+
+## Options
+
+- `-h`, `--help` - show this help message and exit
+- `-q`, `--quiet` - Be quiet.
+- `-v`, `--verbose` - Be verbose.

content/docs/command-reference/studio/token.md

@@ -0,0 +1,22 @@
+## studio token
+
+This command helps to log out user from DVC Studio.
+
+## Synopsis
+
+```usage
+usage: dvc studio token [-h] [-q | -v]
+```
+
+## Description
+
+`dvc token` shows the studio token stored in global [DVC configuration].
+
+[dvc configuration]:
+  /doc/user-guide/project-structure/configuration#config-file-locations
+
+## Options
+
+- `-h`, `--help` - show this help message and exit
+- `-q`, `--quiet` - Be quiet.
+- `-v`, `--verbose` - Be verbose.

content/docs/sidebar.json

@@ -574,6 +574,29 @@
         "label": "status",
         "slug": "status"
       },
+      {
+        "label": "studio",
+        "slug": "studio",
+        "source": "studio/index.md",
+        "children": [
+          {
+            "label": "studio login",
+            "slug": "login"
+          },
+          {
+            "label": "studio logout",
+            "slug": "logout"
+          },
+          {
+            "label": "studio logout",
+            "slug": "logout"
+          },
+          {
+            "label": "studio token",
+            "slug": "token"
+          }
+        ]
+      },
       {
         "label": "unfreeze",
         "slug": "unfreeze"