diff --git a/README.md b/README.md index 6a27d72..bd2160f 100644 --- a/README.md +++ b/README.md @@ -105,7 +105,7 @@ quix login ### Get Started -After setting up your context and logging in you will be able to access your Quix organisation. For more information visit [Quix Docs](https://quix.io/docs/get-started/cli.html). +After setting up your context and logging in you will be able to access your Quix organisation. For more information visit [Quix Docs](https://quix.io/docs/cli/overview.html). ### Using dedicated Quix clusters diff --git a/docs/Reference/applications/index.gen.md b/docs/Reference/applications/index.gen.md new file mode 100644 index 0000000..c6c5871 --- /dev/null +++ b/docs/Reference/applications/index.gen.md @@ -0,0 +1,20 @@ +# applications + +## Overview + +Manage the applications of an environment + +**Aliases:** applications, application, apps, app + +**Usage:** + +``` +quix applications [command] [options] +``` + +**Commands:** + +- [get](get.md) : Get an application in the specified environment +- [library](library\index.md) : Manage the library items of an environment +- [list](list.md) : Get all applications in the specified environment + diff --git a/docs/Reference/applications/index.md b/docs/Reference/applications/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/applications/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/applications/library/index.gen.md b/docs/Reference/applications/library/index.gen.md new file mode 100644 index 0000000..b4e630d --- /dev/null +++ b/docs/Reference/applications/library/index.gen.md @@ -0,0 +1,18 @@ +# applications library + +## Overview + +Manage the library items of an environment + +**Aliases:** library + +**Usage:** + +``` +quix applications library [command] [options] +``` + +**Commands:** + +- [list](list.md) : Get all library items + diff --git a/docs/Reference/applications/library/index.md b/docs/Reference/applications/library/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/applications/library/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/contexts/broker/index.gen.md b/docs/Reference/contexts/broker/index.gen.md new file mode 100644 index 0000000..da0509a --- /dev/null +++ b/docs/Reference/contexts/broker/index.gen.md @@ -0,0 +1,21 @@ +# contexts broker + +## Overview + +Manage the local broker of the current context + +**Aliases:** broker + +**Usage:** + +``` +quix contexts broker [command] [options] +``` + +**Commands:** + +- [disable](disable.md) : Disables the use of a local broker of the current context +- [enable](enable.md) : Enables the use of a local broker of the current context +- [set](set.md) : Sets the address for the local broker of the current context +- [toggle](toggle.md) : Toggles the usage of a local broker of the current context + diff --git a/docs/Reference/contexts/broker/index.md b/docs/Reference/contexts/broker/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/contexts/broker/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/contexts/environments/index.gen.md b/docs/Reference/contexts/environments/index.gen.md new file mode 100644 index 0000000..fc8d07c --- /dev/null +++ b/docs/Reference/contexts/environments/index.gen.md @@ -0,0 +1,20 @@ +# contexts environments + +## Overview + +Manage the default environment + +**Aliases:** environments, environment, envs, env, workspaces, workspace + +**Usage:** + +``` +quix contexts environments [command] [options] +``` + +**Commands:** + +- [clear](clear.md) : Unset the default environment of the current context +- [get](get.md) : Get the default environment of the current context +- [use](use.md) : Select the default environment for the current context + diff --git a/docs/Reference/contexts/environments/index.md b/docs/Reference/contexts/environments/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/contexts/environments/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/contexts/index.gen.md b/docs/Reference/contexts/index.gen.md new file mode 100644 index 0000000..5753f22 --- /dev/null +++ b/docs/Reference/contexts/index.gen.md @@ -0,0 +1,25 @@ +# contexts + +## Overview + +Manage the contexts for the CLI + +**Aliases:** contexts, context, ctx + +**Usage:** + +``` +quix contexts [command] [options] +``` + +**Commands:** + +- [broker](broker\index.md) : Manage the local broker of the current context +- [create](create.md) : Add a new context to the CLI +- [current](current.md) : Gets information about the current context +- [delete](delete.md) : Remove a context from the CLI +- [environments](environments\index.md) : Manage the default environment +- [list](list.md) : Get all contexts +- [reset](reset.md) : Resets your context to defaults +- [use](use.md) : Uses the specified context + diff --git a/docs/Reference/contexts/index.md b/docs/Reference/contexts/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/contexts/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/deployments/index.gen.md b/docs/Reference/deployments/index.gen.md new file mode 100644 index 0000000..c7cba0f --- /dev/null +++ b/docs/Reference/deployments/index.gen.md @@ -0,0 +1,23 @@ +# deployments + +## Overview + +Manage the deployments of an environment + +**Aliases:** deployments, deployment + +**Usage:** + +``` +quix deployments [command] [options] +``` + +**Commands:** + +- [get](get.md) : Get the details for a deployment +- [list](list.md) : Get the information for all the deployments in an environment +- [logs](logs.md) : Get deployments logs +- [metrics](metrics.md) : Get deployments metrics +- [start](start.md) : Start a deployment +- [stop](stop.md) : Stop a deployment + diff --git a/docs/Reference/deployments/index.md b/docs/Reference/deployments/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/deployments/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/environments/index.gen.md b/docs/Reference/environments/index.gen.md new file mode 100644 index 0000000..7383e3b --- /dev/null +++ b/docs/Reference/environments/index.gen.md @@ -0,0 +1,21 @@ +# environments + +## Overview + +Manage the environments + +**Aliases:** environments, environment, envs, env, workspaces, workspace + +**Usage:** + +``` +quix environments [command] [options] +``` + +**Commands:** + +- [get](get.md) : Retrieves details of a specific environment accessible to the currently authenticated user +- [list](list.md) : List all environments the current user has access to +- [sync](sync.md) : Sync your environment based on the attached project +- [use](use.md) : Select the default environment for the current context + diff --git a/docs/Reference/environments/index.md b/docs/Reference/environments/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/environments/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/local/applications/index.gen.md b/docs/Reference/local/applications/index.gen.md new file mode 100644 index 0000000..c533a03 --- /dev/null +++ b/docs/Reference/local/applications/index.gen.md @@ -0,0 +1,21 @@ +# local applications + +## Overview + +Manage your local applications + +**Aliases:** applications, application, apps, app + +**Usage:** + +``` +quix local applications [command] [options] +``` + +**Commands:** + +- [convert](convert.md) : Converts applications from and to library item format +- [create](create.md) : Creates an application locally +- [list](list.md) : lists local applications +- [variables](variables\index.md) : Manage your local application's variables + diff --git a/docs/Reference/local/applications/index.md b/docs/Reference/local/applications/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/local/applications/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/local/applications/variables/create.gen.md b/docs/Reference/local/applications/variables/create.gen.md index df00eca..5b53c0d 100644 --- a/docs/Reference/local/applications/variables/create.gen.md +++ b/docs/Reference/local/applications/variables/create.gen.md @@ -2,7 +2,7 @@ ## Overview -Edits a variable of the current application +Creates a variable of the current application **Aliases:** create, add diff --git a/docs/Reference/local/applications/variables/edit.gen.md b/docs/Reference/local/applications/variables/edit.gen.md index d1693de..8226461 100644 --- a/docs/Reference/local/applications/variables/edit.gen.md +++ b/docs/Reference/local/applications/variables/edit.gen.md @@ -2,7 +2,7 @@ ## Overview -Creates a new variable of the current application +Edits a new variable of the current application **Aliases:** edit diff --git a/docs/Reference/local/applications/variables/import.gen.md b/docs/Reference/local/applications/variables/import.gen.md index 1e47da2..e3810ce 100644 --- a/docs/Reference/local/applications/variables/import.gen.md +++ b/docs/Reference/local/applications/variables/import.gen.md @@ -16,6 +16,5 @@ quix local applications variables import [options] - `--env-file-name ` : [default: .env] - `--directory ` : Base directory (defaults to current directory) -- `--from-app-variables` : If enabled the variables from the .env file will take preference over the ones in the app.yaml file [default: False] - `--reset` : Removes all variables from the app.yaml file and adds them from the .env file [default: False] diff --git a/docs/Reference/local/applications/variables/index.gen.md b/docs/Reference/local/applications/variables/index.gen.md new file mode 100644 index 0000000..a8a8733 --- /dev/null +++ b/docs/Reference/local/applications/variables/index.gen.md @@ -0,0 +1,23 @@ +# local applications variables + +## Overview + +Manage your local application's variables + +**Aliases:** variables, variable, vars, var + +**Usage:** + +``` +quix local applications variables [command] [options] +``` + +**Commands:** + +- [create](create.md) : Creates a variable of the current application +- [delete](delete.md) : Deletes a variable of the current application +- [edit](edit.md) : Edits a new variable of the current application +- [export](export.md) : Exports the variables from app.yaml to an .env file +- [import](import.md) : Imports the .env file values to the app.yaml. The values from the .env file will replace the ones in the app.yaml file +- [list](list.md) : Lists the variables of the current application + diff --git a/docs/Reference/local/applications/variables/index.md b/docs/Reference/local/applications/variables/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/local/applications/variables/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/local/index.gen.md b/docs/Reference/local/index.gen.md new file mode 100644 index 0000000..390db2b --- /dev/null +++ b/docs/Reference/local/index.gen.md @@ -0,0 +1,21 @@ +# local + +## Overview + +Performs local related operations + +**Aliases:** local + +**Usage:** + +``` +quix local [command] [options] +``` + +**Commands:** + +- [applications](applications\index.md) : Manage your local applications +- [pipeline](pipeline\index.md) : Manage your local pipeline and your 'quix.yaml' +- [init](init.md) : Generate the initial Quix files based on the existing repository +- [ide](ide.md) : Setup everything needed for local application development and open your local IDE + diff --git a/docs/Reference/local/index.md b/docs/Reference/local/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/local/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/local/pipeline/deployments/index.gen.md b/docs/Reference/local/pipeline/deployments/index.gen.md new file mode 100644 index 0000000..a34d74d --- /dev/null +++ b/docs/Reference/local/pipeline/deployments/index.gen.md @@ -0,0 +1,22 @@ +# local pipeline deployments + +## Overview + +Manage the local deployments + +**Aliases:** deployments, deployment + +**Usage:** + +``` +quix local pipeline deployments [command] [options] +``` + +**Commands:** + +- [create](create.md) : Get a local deployment +- [delete](delete.md) : Get a local deployment +- [edit](edit.md) : Get a local deployment +- [get](get.md) : Get a local deployment +- [list](list.md) : List the local deployments + diff --git a/docs/Reference/local/pipeline/deployments/index.md b/docs/Reference/local/pipeline/deployments/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/local/pipeline/deployments/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/local/pipeline/index.gen.md b/docs/Reference/local/pipeline/index.gen.md new file mode 100644 index 0000000..ab1ebe7 --- /dev/null +++ b/docs/Reference/local/pipeline/index.gen.md @@ -0,0 +1,23 @@ +# local pipeline + +## Overview + +Manage your local pipeline and your 'quix.yaml' + +**Aliases:** pipeline, pipe + +**Usage:** + +``` +quix local pipeline [command] [options] +``` + +**Commands:** + +- [view](view.md) : Create and preview a mermaid diagram of the pipeline +- [deployments](deployments\index.md) : Manage the local deployments +- [update](update.md) : Update 'quix.yaml' with the new local applications and update the variables of the existing deployments +- [sync](sync.md) : Synchronize your local pipeline to Quix Cloud. +- [up](up.md) : Run your pipeline using docker compose +- [down](down.md) : Stop the execution of your local pipeline + diff --git a/docs/Reference/local/pipeline/index.md b/docs/Reference/local/pipeline/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/local/pipeline/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/organisations/index.gen.md b/docs/Reference/organisations/index.gen.md new file mode 100644 index 0000000..355fdab --- /dev/null +++ b/docs/Reference/organisations/index.gen.md @@ -0,0 +1,18 @@ +# organisations + +## Overview + +Manage your organisation + +**Aliases:** organisations, organisation, organizations, organization, orgs, org + +**Usage:** + +``` +quix organisations [command] [options] +``` + +**Commands:** + +- [get](get.md) : Gets the organisation details the currently authenticated user belongs to + diff --git a/docs/Reference/organisations/index.md b/docs/Reference/organisations/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/organisations/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/projects/index.gen.md b/docs/Reference/projects/index.gen.md new file mode 100644 index 0000000..057fa04 --- /dev/null +++ b/docs/Reference/projects/index.gen.md @@ -0,0 +1,20 @@ +# projects + +## Overview + +Manage the projects of the current organisation + +**Aliases:** projects, project, repositories, repository, repos, repo + +**Usage:** + +``` +quix projects [command] [options] +``` + +**Commands:** + +- [get](get.md) : Get all projects of the current organisation +- [list](list.md) : Get all projects of the current organisation +- [patch](patch.md) : Edit individual properties of a project + diff --git a/docs/Reference/projects/index.md b/docs/Reference/projects/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/projects/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/topics/index.gen.md b/docs/Reference/topics/index.gen.md new file mode 100644 index 0000000..eba428b --- /dev/null +++ b/docs/Reference/topics/index.gen.md @@ -0,0 +1,19 @@ +# topics + +## Overview + +Manage the topics of an environment + +**Aliases:** topics, topic + +**Usage:** + +``` +quix topics [command] [options] +``` + +**Commands:** + +- [get](get.md) : Get information of a topic for the specified environment +- [list](list.md) : Get all topics information for the specified environment + diff --git a/docs/Reference/topics/index.md b/docs/Reference/topics/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/topics/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/users/index.gen.md b/docs/Reference/users/index.gen.md new file mode 100644 index 0000000..ac8d6e5 --- /dev/null +++ b/docs/Reference/users/index.gen.md @@ -0,0 +1,22 @@ +# users + +## Overview + +Manage the users of the current organisation + +**Aliases:** users, user + +**Usage:** + +``` +quix users [command] [options] +``` + +**Commands:** + +- [audit](audit.md) : Get the auditing details of the users of your organization +- [current](current.md) : Gets the details of the currently-authenticated user +- [list](list.md) : List all users in the organisation +- [permissions](permissions\index.md) : Manage the user permissions +- [tokens](tokens\index.md) : Manage the personal access tokens of the current user + diff --git a/docs/Reference/users/index.md b/docs/Reference/users/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/users/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/users/permissions/index.gen.md b/docs/Reference/users/permissions/index.gen.md new file mode 100644 index 0000000..a80ef95 --- /dev/null +++ b/docs/Reference/users/permissions/index.gen.md @@ -0,0 +1,23 @@ +# users permissions + +## Overview + +Manage the user permissions + +**Aliases:** permissions, permission + +**Usage:** + +``` +quix users permissions [command] [options] +``` + +**Commands:** + +- [copy](copy.md) : Copy the user permissions from a user to other users +- [delete](delete.md) : Deletes the value of a single permission of a user in the organisation +- [edit](edit.md) : Adds or edits the value of a single permission of a user in the organisation. Available roles: [Admin, Manager, Editor, Viewer] +- [get](get.md) : Get the permissions of a user or all the users in the organisation +- [list](list.md) : Get the permissions of all the users in the organisation +- [set](set.md) : Sets the whole permissions of a user, replacing the current ones. Available roles: [Admin, Manager, Editor, Viewer] + diff --git a/docs/Reference/users/permissions/index.md b/docs/Reference/users/permissions/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/users/permissions/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/docs/Reference/users/tokens/create.gen.md b/docs/Reference/users/tokens/create.gen.md index 02a2554..817a1fe 100644 --- a/docs/Reference/users/tokens/create.gen.md +++ b/docs/Reference/users/tokens/create.gen.md @@ -19,6 +19,6 @@ quix users tokens create [options] **Options:** - `-o, --output ` : Output type of the retrieved data -- `--expires-at ` : Define when the token will expire. Supports ISO 8601 dates: 'YYYY-MM-DD HH:MM:SS.sss'. All times UTC. [default: 2025-06-07] +- `--expires-at ` : Define when the token will expire. Supports ISO 8601 dates: 'YYYY-MM-DD HH:MM:SS.sss'. All times UTC. [default: 2025-06-11] - `-p, --permission-assignments (REQUIRED)` : Array of permission assignments in the format "[{Scope, Permission, Permission, ..}, {Scope, Permission, Permission, ..}, ...]" diff --git a/docs/Reference/users/tokens/index.gen.md b/docs/Reference/users/tokens/index.gen.md new file mode 100644 index 0000000..72be8e4 --- /dev/null +++ b/docs/Reference/users/tokens/index.gen.md @@ -0,0 +1,21 @@ +# users tokens + +## Overview + +Manage the personal access tokens of the current user + +**Aliases:** tokens, token + +**Usage:** + +``` +quix users tokens [command] [options] +``` + +**Commands:** + +- [create](create.md) : Creates a new personal access token +- [edit](edit.md) : Edits an existing personal access token +- [list](list.md) : Gets all the personal access tokens of the current user +- [revoke](revoke.md) : Revokes an existing personal access token + diff --git a/docs/Reference/users/tokens/index.md b/docs/Reference/users/tokens/index.md new file mode 100644 index 0000000..2bd196e --- /dev/null +++ b/docs/Reference/users/tokens/index.md @@ -0,0 +1 @@ +{% include-markdown './index.gen.md' %} \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 9e85ce0..f29faf0 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -44,12 +44,15 @@ nav: - 'Using the CLI with GitHub Actions': 'cli-github-actions.md' - Reference: - applications: + - Reference/applications/index.md - applications get: Reference/applications/get.md - applications list: Reference/applications/list.md - applications library: + - Reference/applications/library/index.md - applications library list: Reference/applications/library/list.md - login: Reference/login.md - contexts: + - Reference/contexts/index.md - contexts create: Reference/contexts/create.md - contexts current: Reference/contexts/current.md - contexts list: Reference/contexts/list.md @@ -57,15 +60,18 @@ nav: - contexts reset: Reference/contexts/reset.md - contexts use: Reference/contexts/use.md - contexts environments: + - Reference/contexts/environments/index.md - contexts environments clear: Reference/contexts/environments/clear.md - contexts environments get: Reference/contexts/environments/get.md - contexts environments use: Reference/contexts/environments/use.md - contexts broker: + - Reference/contexts/broker/index.md - contexts broker disable: Reference/contexts/broker/disable.md - contexts broker enable: Reference/contexts/broker/enable.md - contexts broker set: Reference/contexts/broker/set.md - contexts broker toggle: Reference/contexts/broker/toggle.md - deployments: + - Reference/deployments/index.md - deployments get: Reference/deployments/get.md - deployments list: Reference/deployments/list.md - deployments logs: Reference/deployments/logs.md @@ -73,16 +79,20 @@ nav: - deployments start: Reference/deployments/start.md - deployments stop: Reference/deployments/stop.md - environments: + - Reference/environments/index.md - environments get: Reference/environments/get.md - environments list: Reference/environments/list.md - environments use: Reference/environments/use.md - environments sync: Reference/environments/sync.md - local: + - Reference/local/index.md - local applications: + - Reference/local/applications/index.md - local applications convert: Reference/local/applications/convert.md - local applications create: Reference/local/applications/create.md - local applications list: Reference/local/applications/list.md - local applications variables: + - Reference/local/applications/variables/index.md - local applications variables create: Reference/local/applications/variables/create.md - local applications variables delete: Reference/local/applications/variables/delete.md - local applications variables edit: Reference/local/applications/variables/edit.md @@ -92,7 +102,9 @@ nav: - local ide: Reference/local/ide.md - local init: Reference/local/init.md - local pipeline: + - Reference/local/pipeline/index.md - local pipeline deployments: + - Reference/local/pipeline/deployments/index.md - local pipeline deployments create: Reference/local/pipeline/deployments/create.md - local pipeline deployments delete: Reference/local/pipeline/deployments/delete.md - local pipeline deployments edit: Reference/local/pipeline/deployments/edit.md @@ -104,19 +116,24 @@ nav: - local pipeline update: Reference/local/pipeline/update.md - local pipeline view: Reference/local/pipeline/view.md - organisations: + - Reference/organisations/index.md - organisations get: Reference/organisations/get.md - projects: + - Reference/projects/index.md - projects patch: Reference/projects/patch.md - projects get: Reference/projects/get.md - projects list: Reference/projects/list.md - status: Reference/status.md - topics: + - Reference/topics/index.md - topics get: Reference/topics/get.md - topics list: Reference/topics/list.md - update: Reference/update.md - users: + - Reference/users/index.md - users audit: Reference/users/audit.md - users permissions: + - Reference/users/permissions/index.md - users permissions copy: Reference/users/permissions/copy.md - users permissions delete: Reference/users/permissions/delete.md - users permissions edit: Reference/users/permissions/edit.md @@ -124,6 +141,7 @@ nav: - users permissions list: Reference/users/permissions/list.md - users permissions set: Reference/users/permissions/set.md - users tokens: + - Reference/users/tokens/index.md - users tokens create: Reference/users/tokens/create.md - users tokens edit: Reference/users/tokens/edit.md - users tokens list: Reference/users/tokens/list.md