Initial Commit (not yet MVP 1.0)

source/includes/minio-kubernetes-operator.rst

@@ -0,0 +1,21 @@
+.. tabs::
+
+   .. tab:: SSH
+
+      .. code-block:: shell
+         :class: copyable
+
+         mkdir -p ~/minio-kubernetes/git
+         cd ~/minio-examples/git
+
+         git clone git@github.com:minio/minio-operator.git
+
+   .. tab:: HTTPS
+
+      .. code-block:: shell
+         :class: copyable
+
+         mkdir -p ~/minio-kubernetes/git
+         cd ~/minio-examples/git
+
+         git clone https://github.com/minio/minio-operator.git

source/includes/minio-mc-installation.rst

@@ -0,0 +1,112 @@
+.. tabs::
+
+   .. tab:: Docker
+
+      **Stable**
+
+      .. code-block:: shell
+         :class: copyable
+
+         docker pull minio/mc
+         docker run minio/mc admin info play
+
+      **Edge**
+
+      *Do not use bleeding-edge deployments of MinIO in production environments*
+
+      .. code-block:: shell
+         :class: copyable
+
+         docker pull minio/mc:edge
+         docker run minio/mc:edge admin info server play
+
+
+   .. tab:: Linux
+
+      The following commands add a *temporary* extension to your system
+      PATH for running the ``mc`` utility. Defer to your operating system
+      instructions for making permanent modifications to your system PATH.
+
+      Alternatively, execute ``mc`` by navigating to the parent folder and
+      running ``./mc --help``
+
+      **64-bit Intel**
+
+      .. code-block:: shell
+         :class: copyable
+
+         curl https://dl.min.io/client/mc/release/linux-amd64/mc \
+           --create-dirs \
+           -o $HOME/minio-binaries/mc
+
+         chmod +x $HOME/minio-binaries/mc
+         export PATH=$PATH:$HOME/minio-binaries/
+
+         mc --help
+
+      **64-bit PPC**
+
+      .. code-block:: shell
+         :class: copyable
+
+         curl https://dl.min.io/client/mc/release/linux-ppc64le/mc \
+           --create-dirs \
+           -o ~/minio-binaries/mc
+
+         chmod +x $HOME/minio-binaries/mc
+         export PATH=$PATH:$HOME/minio-binaries/
+
+         mc --help
+
+   .. tab:: macOS
+
+      .. code-block:: shell
+         :class: copyable
+
+         brew install minio/stable/mc
+         mc --help
+
+
+   .. tab:: Windows
+
+      Open the following file in a browser:
+      
+      https://dl.min.io/client/mc/release/windows-amd64/mc.exe
+
+      Execute the file by double clicking on it, *or* by running the
+      following in the command prompt or powershell:
+
+      .. code-block:: powershell
+
+         \path\to\mc.exe --help
+
+   .. tab:: Source
+
+      Source installation is intended for developers and advanced users. The
+      :mc-cmd:`mc admin update` command does not support updating source-based
+      installations.
+
+      Source installation requires a working Golang environment. 
+      See `How to install Golang <https://golang.org/doc/install>`__
+
+      .. code-block:: shell
+         :class: copyable
+
+         go get -d github.com/minio/mc
+         cd ${GOPATH}/src/github.com/minio/mc
+         make
+
+:command:`mc` includes the https://play.min.io MinIO server for testing
+and development under the ``play`` alias. If the host machine has access to
+the public internet, you can use the ``play`` alias for testing and development
+purposes. For example, the following lists all buckets on 
+``https://play.min.io``:
+
+.. code-block:: shell
+   :class: copyable
+
+   mc ls play
+
+The ``play`` alias is strictly for testing and development. Any S3-compatible
+tool can view and interact with data on ``play``. You should only store data on
+``play`` that is safe for public interaction. 

source/includes/play-alias-available.rst

@@ -0,0 +1,32 @@
+play-alias-only
+
+The following example assumes that the ``play`` alias exists in the
+:mc-cmd:`mc` :ref:`configuration file <mc-configuration>`. You can
+replace ``play`` with the alias for your preferred S3-compatible deployment.
+
+See :mc-cmd:`mc alias` for more information on aliases.
+
+end-play-alias-only
+
+
+play-s3-alias
+
+The following example assumes that the ``play`` and ``s3`` aliases exist in the
+:mc-cmd:`mc` :ref:`configuration file <mc-configuration>`. You can replace
+``play`` and ``s3`` with the aliases for your preferred S3-compatible
+deployments.
+
+See :mc-cmd:`mc alias` for more information on aliases.
+
+end-play-s3-alias
+
+myminio-alias
+
+The following example uses the default ``myminio`` alias. The ``myminio``
+alias points to a local ``minio`` server running on port ``9000``. See 
+<installation instructions> for more information on installing and running
+a local ``minio`` server instance.
+
+See :mc-cmd:`mc alias` for more information on aliases.
+
+end-myminio-alias