Update time.rst

Removed adding the polkit and instead added sudo to the timecatectl set-ntp command.

.github/workflows/greetings.yml

@@ -0,0 +1,13 @@
+name: Greetings
+
+on: [pull_request, issues]
+
+jobs:
+  greeting:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/first-interaction@v1
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        issue-message: 'Welcome to Clear Linux* OS Docs. Thanks for submitting your first issue.'
+        pr-message: 'Welcome to Clear Linux* OS Docs. Thanks for submitting your first PR.'

Makefile

@@ -34,7 +34,6 @@ clean:
 	rm -rf venv
 
 venv:
-	virtualenv -p python$(PY_VERSION) venv;
+	virtualenv venv;\
 	source venv/bin/activate; \
 	pip3 install -r requirements.txt;
-

README.rst

@@ -65,7 +65,87 @@ to view the rendered documentation.
 
 If you want to build the documentation exactly as seen on the website, use
 ``make py`` followed by ``make htmlall``. This builds some
-external dependenices and all supported languages.
+external dependencies and all supported languages.
+
+Use virtualenv 
+**************
+
+To develop documentation in a ``virtualenv``, use the ``venv`` target.
+The Clear Linux OS documentation make target ``venv`` provides a 
+simple development environment that ensures that you have the 
+latest packages and that you manage Python versions separately. Use of the 
+``virtualenv`` requires **Python 3.6** or higher. For Windows examples below, use Powershell as an Administrator.
+
+The **virtual environment** uses the same version of Python that was used to **create the virtual environment**. 
+
+Verify ``pip`` is installed. A file path to pip should appear. 
+
+On Clear Linux OS and macOS\*:
+
+.. code-block:: bash
+
+   which pip
+   
+On Windows\* 10 OS: 
+
+.. code-block:: bash
+
+   pip --version
+
+If ``pip`` is not installed, install it. 
+
+On Clear Linux OS and macOS:
+
+.. code-block:: bash
+
+   python3 -m pip install --user --upgrade pip
+
+On Windows 10 OS: 
+
+.. code-block:: bash
+
+   py -m pip install --upgrade pip
+
+.. note::
+
+   This assumes Python was already added to your Windows path. 
+
+Install virtualenv 
+==================
+
+Install ``virtualenv``. 
+
+On Clear Linux OS and macOS\*:
+
+.. code-block:: bash
+
+   python3 -m pip install --user virtualenv
+
+On Windows 10 OS: 
+
+.. code-block:: bash
+
+   py -m pip install --user virtualenv
+
+Create the ``virtualenv`` and install the required packages: 
+
+.. code-block:: bash
+
+   make venv
+
+Activate the ``venv``. 
+
+.. code-block:: bash
+
+   source venv/bin/activate
+
+Follow `Run the build`_ section to start developing documentation.
+
+Remove the ``venv`` when finished developing.  
+
+.. code-block:: bash
+
+   deactivate
 
 Additional help
 ***************
@@ -80,7 +160,8 @@ build before building again by running ``make clean``:
 
    make clean
 
-This will completely remove the previous build output.
+This will completely remove the previous build output, including artifacts 
+from the `make venv` target when done outside an active venv.
 
 Convenience script
 ==================
@@ -98,6 +179,6 @@ To stop the web server simply use ``ctrl-c``.
 .. _Clear Linux\* OS documentation:  https://docs.01.org/clearlinux/
 .. _Sphinx: http://sphinx-doc.org/
 .. _reStructuredText: http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
-.. _contribution guidelines: https://clearlinux.org/documentation/clear-linux/reference/collaboration
+.. _contribution guidelines: https://docs.01.org/clearlinux/latest/collaboration/collaboration.html
 .. _instructions for installing Sphinx: https://www.sphinx-doc.org/en/master/usage/installation.html
 

requirements.txt

@@ -6,3 +6,4 @@ sphinx-intl==2.0.0
 sphinx-sitemap==1.0.2
 Jinja2==2.10.1
 GitPython==2.1.11
+sphinx-tabs

source/FAQ/index.rst

@@ -16,7 +16,7 @@ Why did you make another distro?
 ================================
 
 The |CL| team felt that performance was left on the table with Linux software.
-|CL| takes a holistic approach to improving performance across the stack. We
+|CL| takes a holistic approach to improve performance across the stack. We
 also wanted to take more modern approaches with OS updates and tooling.
 
 |
@@ -31,7 +31,7 @@ Yes, we absolutely love open source reuse and upstreaming improvements.
 How often do you update?
 ========================
 
-The |CL| team puts out multiple releases a week, often releasing 2 or more
+The |CL| team puts out multiple releases a week, often releasing two or more
 times a day. This rolling release approach allows |CL| to remain agile to
 upstream changes and security patches.
 
@@ -137,7 +137,7 @@ Is Microsoft\* Visual Studio Code\* available?
 
 Yes. Find the CLI command for installing `VS Code`_ and other Flatpak apps in
 the `software store`_. Installing Flatpak apps is also covered in our
-:ref:`tutorial <flatpak-tutorial>`. 
+:ref:`tutorial <flatpak-tutorial>`.
 
 The |CL| team is working on a natively packaged version of Visual Studio Code
 for future release.

source/_figures/digitalocean/Readme.txt

@@ -0,0 +1,18 @@
+1) Capture screenshot
+2) Open in GIMP 2.10
+3) Select the area of interest
+4) Copy the selection; take note of X, Y dimensions of the selection
+5) "File" > "New"
+   - Add 100 extra pixels to X for the "Width"
+   - Add 100 extra pixels to Y for the "Height"
+   - Set "Fill with" to "Transparency"
+6) Switch from the "Selection" tool to the "Move" tool and move the 
+   the top-left corner of the image to 2 squares down and 2 squares across
+7) Right-click the image and select "Layer" > "Anchor Layer"
+8) "Filters" > "Decor" > "Light and Shadow" > "Drop Shadow" 
+   - X = 20.0
+   - Y = 20.0
+   - Radius = 20.0
+   - Opacity = 0.2
+
+