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.'

.gitignore

@@ -14,3 +14,6 @@ source/_build
 # ignore artifacts generated by running make py
 cloned_repo
 bundles.html.txt
+
+# ignore the venv, used for running make py
+venv

.travis.yml

@@ -4,23 +4,33 @@ python:
   - "3.6"
 
 # command to install dependencies
-install: 
+install:
   - pip3 install -q -r requirements.txt
-  - pip3 install -q -r source/_scripts/_python/requirements.txt
 
 # command to run tests
-script: 
+script:
   - make py
   - make htmlall
 
 before_deploy:
   - make linkcheck
+  # only deploy the latest tagged release of Simplified Chinese docs
+  - wget https://github.com/clearlinux/clear-linux-documentation-zh-CN/releases/latest/download/clearlinux-docs-zh-CN.tar.gz
+  - mkdir source/_build/html/zh_CN
+  - tar xvzf clearlinux-docs-zh-CN.tar.gz -C source/_build/html/zh_CN
 
 deploy:
   - provider: pages
     skip_cleanup: true
     github_token: $GITHUB_TOKEN
     target-branch: latestHTML
+    on:
+      branch: publish
+    local_dir: source/_build/html/
+  - provider: pages
+    skip_cleanup: true
+    github_token: $GITHUB_TOKEN
+    target-branch: developmentHTML
     on:
       branch: master
     local_dir: source/_build/html/
@@ -31,7 +41,14 @@ deploy:
     on:
       branch: development
     local_dir: source/_build/html/
+  - provider: releases
+    skip_cleanup: true
+    api_key: $GITHUB_TOKEN
+    file: clearlinux-docs-zh-CN.tar.gz
+    on:
+      tags: true
+
 
 after_deploy:
   - wget $PUBLISH_URL
-  - cat clearlinux-latest
+  - cat clearlinux-latest

Makefile

@@ -1,5 +1,8 @@
 # Makefile for Sphinx documentation
-#
+
+SHELL := /bin/bash
+
+PY_VERSION ?= 3.6
 
 all:
 	make -C source html
@@ -28,4 +31,9 @@ help:
 
 clean:
 	make -C source clean
+	rm -rf venv
 
+venv:
+	virtualenv venv;\
+	source venv/bin/activate; \
+	pip3 install -r requirements.txt;

README.rst

@@ -10,38 +10,46 @@ documentation locally for development and testing.
 Please make yourself familiar with our `contribution guidelines`_ before
 submitting a contribution.
 
-Requirements
-************
-
-Make sure you have Python and Sphinx installed. We use Python 3 and
-Sphinx 1.7.5
-
-The Sphinx documentation provides `instructions for installing Sphinx`_ on various
-platforms.
-
 Clone the documentation repository
 **********************************
 
-Once Sphinx is installed, clone the documentation repository to your
-local machine.
+Clone the documentation repository to your local machine.
 
-.. code-block:: console
+.. code-block:: bash
 
-   $ git clone https://github.com/clearlinux/clear-linux-documentation
+   git clone https://github.com/clearlinux/clear-linux-documentation
+
+Requirements
+************
+
+Make sure you have Python 3 installed to start.
+
+The Sphinx documentation provides `instructions for installing Sphinx`_
+on various platforms.
+
+Use pip3 to install additional Python dependencies listed in the
+requirements.txt file found in the repository:
+
+.. code-block:: bash
+
+   pip3 install -r requirements.txt
 
 Run the build
 *************
 
 We build our documentation using Sphinx. In the source directory of your
-local clear-linux-documentation repository, build the documentation by running
-**make html**:
+local clear-linux-documentation repository, preview changes to the
+documentation by building the docs in the default language (English) by
+running ``make html``:
+
+.. code-block:: bash
+
+   make html
 
 .. code-block:: console
 
-   $ make html
-   >
    sphinx-build -b html -d _build/doctrees   . _build/html
-   Running Sphinx v1.7.5
+   Running Sphinx v1.8.0
    making output directory...
    .
    .
@@ -52,23 +60,125 @@ local clear-linux-documentation repository, build the documentation by running
 
    Build finished. The HTML pages are in _build/html.
 
-Open one of the HTML pages in a web browser to view the rendered
-documentation.
+Open one of the HTML pages found in ``source/_build/html`` in a web browser
+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 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
+***************
+
+Cleaning up
+===========
 
 When testing changes in the documentation, make sure to remove the previous
-build before building again by running **make clean**:
+build before building again by running ``make clean``:
 
-.. code-block:: console
+.. code-block:: bash
 
-   $ make clean
-   >
-   rm -rf _build/*
+   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.
 
-.. _Clear Linux\* OS documentation:  https://clearlinux.org/documentation
+Convenience script
+==================
+
+This bash script (Linux only) includes both ``make clean`` and
+``make html``. It also starts a simple Python web server that
+displays a preview of the site at http://localhost:8000 on your local machine.
+
+.. code-block:: bash
+
+   ./checkwork.sh
+
+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

@@ -3,4 +3,7 @@ sphinx==1.8
 docutils==0.14
 sphinx_rtd_theme
 sphinx-intl==2.0.0
-sphinx-sitemap==1.0.2
+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/Makefile

@@ -53,10 +53,11 @@ help:
 
 clean:
 	rm -rf $(BUILDDIR)/*
+	rm -rf reference/bundles/*.txt
 
-htmlall: 
+htmlall:
 	$(SPHINXBUILD) -b html $(ERROROPTS) $(ALLSPHINXOPTS) $(BUILDDIR)/html	
-	$(SPHINXBUILD) -b html $(ERROROPTS) -D language='zh_CN' $(ALLSPHINXOPTS) $(BUILDDIR)/html/zh_CN 
+	$(SPHINXBUILD) -b html $(ERROROPTS) -D language='zh_CN' $(ALLSPHINXOPTS) $(BUILDDIR)/zh_CN 
 
 htmlde:
 	$(SPHINXBUILD) -b html -D language='de' $(ALLSPHINXOPTS) $(BUILDDIR)/html/de 

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
+
+