Simplify getting started

mottosso · Jul 30, 2019 · 7c43101 · 7c43101
1 parent cfbcdce
commit 7c43101
Show file tree

Hide file tree

Showing 3 changed files with 51 additions and 13 deletions.
diff --git a/docs/pages/index.md b/docs/pages/index.md
@@ -48,17 +48,29 @@ template: landing.html
 -->
 
 <div class="hboxlayout row-reverse">
-    <div class="vboxlayout">
+    <div class="vboxlayout" markdown="1">
         <h2>Package Based</h2>
         <p>
-Libraries, applications, projects.. package everything!
-<br>
+Works on your machine?
 <br>
-Allzpark is a package-based launcher, which means that everything related to a project is encapsulated into individual, version controlled and dependency managed "packages".
 <br>
+Allzpark is a package-based launcher, which means that everything related to a project is encapsulated into individual, version controlled and dependency managed "packages". Each coming together to form an environment identical across your development machine and anywhere your software is used.
 <br>
-Establish complex relationships between software, applications and projects with <a href="https://github.com/mottosso/bleeding-rez">bleeding-rez</a>, the underlying framework powering <b>Allzpark</b>.
+</p>
+
+```python
+# A package definition
+name = "blender"
+version = "2.80"
+
+def commands():
+    global env
+    env["PATH"].append("{root}/bin")
+    env["PYTHONPATH"].prepend("{root}/python")
+```
 
+<p>
+Establish complex relationships between software, applications and projects with <a href=https://github.com/mottosso/bleeding-rez>bleeding-rez</a>, the underlying framework powering Allzpark.
 </p>
     </div>
     <div class="smallspace"></div>
@@ -78,22 +90,41 @@ Establish complex relationships between software, applications and projects with
 <div class="hboxlayout">
     <div class="vboxlayout">
         <h2>Dual Representation</h2>
-        <p>
 
+<p>
 Allzpark is but a shell.
 
 Anything done via the GUI is available via the command-line, using standard Rez commands.
+</p>
+
+<div class="tabs">
+  <button class="tab powershell " onclick="setTab(event, 'powershell')"><p>powershell</p><div class="tab-gap"></div></button>
+  <button class="tab bash " onclick="setTab(event, 'bash')"><p>bash</p><div class="tab-gap"></div></button>
+</div>
+
+<div class="tab-content powershell" markdown="1">
+
+```powershell
+PS> rez env alita maya -q
+> PS> echo "Hello Rez!"
+> # Hello Rez!
+```
+
+</div>
+
+<div class="tab-content bash" markdown="1">
 
 ```bash
 $ rez env alita maya -q
 > $ echo "Hello Rez!"
-Hello Rez!
+# Hello Rez!
 ```
 
-</p>
-    </div>
-    <div class="smallspace"></div>
-    <img class="poster" src=https://user-images.githubusercontent.com/2152766/60496077-fbd5a700-9ca9-11e9-8ff4-09c272326fae.gif>
+</div>
+
+</div>
+<div class="smallspace"></div>
+<img class="poster" src=https://user-images.githubusercontent.com/2152766/60496077-fbd5a700-9ca9-11e9-8ff4-09c272326fae.gif>
 </div>
 
 <div class="space"></div>

diff --git a/docs/pages/quickstart.md b/docs/pages/quickstart.md
@@ -9,9 +9,11 @@ The below commands will install Allzpark and its dependencies, including Rez.
 ```bash
 python -m pip install allzpark --upgrade
 rez bind --quickstart
-allzpark --demo
+allzpark --demo --clean
 ```
 
+> Skip the `--clean` flag to preserve preferences, such as window layout, between runs.
+
 <br>
 
 #### Troubleshooting

diff --git a/setup.py b/setup.py
@@ -61,7 +61,12 @@
     install_requires=[
         "bleeding-rez>=2.38.2",
         "allzparkdemo>=1",
-        "PySide2",
+
+        # Specifically for Python 2..
+        "PySide; python_version<'3'",
+
+        # ..and likewise for Python 3
+        "PySide2; python_version>'3'",
     ],
     python_requires=">2.7, <4",
 )