From df560ca04af89923b68ae6aa2526f36a303e7332 Mon Sep 17 00:00:00 2001
From: Noah Gorny <noah@gittabags.com>
Date: Sun, 18 Apr 2021 21:53:34 +0300
Subject: [PATCH] docs: Add profile command docs

---
 docs/commands/index.rst   |  1 +
 docs/commands/profile.rst | 31 +++++++++++++++++++++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 docs/commands/profile.rst

diff --git a/docs/commands/index.rst b/docs/commands/index.rst
index 3eee3b3a..3890a139 100644
--- a/docs/commands/index.rst
+++ b/docs/commands/index.rst
@@ -13,3 +13,4 @@ You should be familiar with them in order to fully utilize Bash-it.
    search
    reload
    doctor
+   profile
diff --git a/docs/commands/profile.rst b/docs/commands/profile.rst
new file mode 100644
index 00000000..67ca9b5b
--- /dev/null
+++ b/docs/commands/profile.rst
@@ -0,0 +1,31 @@
+.. _profile:
+
+Bash-it Profile
+---------------
+
+Have you ever wanted to port your *Bash-it* configuration into another machine?
+
+If you did, then ``bash-it profile`` is for you!
+
+This command can save and load custom *"profile"* files, that can be later
+used to load and recreate your configuration, in any machine you would like |:smile:|
+
+When porting your configuration into a new machine, you just need to save your current profile, copy the resulting *"profile"* file, and load it in the other machine.
+
+Example
+^^^^^^^
+
+.. code-block:: bash
+
+     # Saves your current profile
+     bash-it profile save my_profile
+     # Load the default profile, which is the one used in the default installation.
+     bash-it profile load default
+
+     # Do whatever you want:
+     # Disable stuff
+     bash-it disable ...
+     # Enable stuff
+     bash-it enable ...
+     # If you want to get back into your original configuration, you can do it easily
+     bash-it profile load my_profile