From dd0a42a20dff3dd27329f2542a0c92587b60b131 Mon Sep 17 00:00:00 2001 From: peterdamian Date: Thu, 30 Nov 2017 17:22:57 -0500 Subject: [PATCH] Rewrite a couple of small sections, clarify that images cannot have captions. --- .../installation/source_installation.rst | 16 +++++++++++++--- style_guide.rst | 5 +++-- user_manual/files/access_webdav.rst | 19 +++++++++---------- 3 files changed, 25 insertions(+), 15 deletions(-) diff --git a/admin_manual/installation/source_installation.rst b/admin_manual/installation/source_installation.rst index 7928ae1f3..8561ef795 100644 --- a/admin_manual/installation/source_installation.rst +++ b/admin_manual/installation/source_installation.rst @@ -35,11 +35,21 @@ archive `_. Installing on Windows (virtual machine) --------------------------------------- -If you are using Windows, the easiest way to get Nextcloud up an running is using our Virtual Machine. The VM is mainly maintainted by Tech and Me and are offered in several different versions. The main version is for VMware version 10 and comes in different sizes. The standard size is 20 GB, but you can also download a 500 GB and a 1 TB version. Tech and Me also provides a Hyper-V version for all Hyper-V users. +If you are using Windows, the easiest way to get Nextcloud up and running is +using a `Nextcloud virtual machine (VM) `_. +The VMs are maintained by `Tech and Me `_ and +several different versions are offered. The main version is for VMware version +10 and it comes in different sizes. The standard size is 20 GB but you can also +download a 500 GB or a 1 TB version. Tech and Me also provides a Hyper-V +version for Hyper-V users. -You can find complete instructions and downloads here: https://github.com/nextcloud/vm or here https://www.techandme.se/nextcloud-vm/ +For complete instructions and downloads see: -Of course you can also install it on other OSes than Windows and you are not limited to any OS really as long as your hypervisor can mount OVA, VMDK, or VHD. +- https://github.com/nextcloud/vm +- https://www.techandme.se/nextcloud-vm/ + +.. note:: You can install the VM on OSes other than Windows as long as +your hypervisor can mount OVA, VMDK, or VHD VM formats. .. _snaps_label: diff --git a/style_guide.rst b/style_guide.rst index 83b5bb925..030dcfc1f 100644 --- a/style_guide.rst +++ b/style_guide.rst @@ -119,8 +119,9 @@ form on the Nextcloud admin page, narrow your Web browser to fold the fields into a smaller space, because a long skinny graphic is not very readable. Think square. -All images must have alt tags, which are brief and descriptive, and figure -numbers. Sphinx RST markup does not have a tag for figure numbers, so you must +Both images and figures must have brief and descriptive alt tags and all +figures must have captions with figure numbers. Sphinx RST markup does not +have a tag for figure numbers, so you must use the caption element. You may use simple numbering like "Figure 1, Figure 2", or add a caption. Captions must follow a blank line and be italicized, like this example:: diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index e0e626421..9642674f5 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -11,20 +11,19 @@ recommended way of connecting client devices to your Nextcloud servers. Nextcloud Desktop and mobile clients ------------------------------------ -The recommended method for keeping your desktop PC synchronized with your -Nextcloud server is by using the `Nextcloud/ownCloud sync clients -`_. You can configure the client -to save files in any local directory you want, and you choose which directories -on the Nextcloud server to sync with. The client displays the current connection -status and logs all activity, so you always know which remote files have been -downloaded to your PC, and you can verify that files created and updated on your -local PC are properly synchronized with the server. +The recommended way to synchronize a desktop PC with a Nextcloud server is by +using `Nextcloud/ownCloud sync clients `_. You can configure the +client to save files in any local directory and you can choose which +directories on the Nextcloud server to sync with. The client displays the +current connection status and logs all activity, so you always know which +remote files have been downloaded to your PC and you can verify that files +created and updated on your local PC are properly synchronized with the server. -The recommended method for syncing your Nextcloud server with Android and +The recommended way to synchronize Nextcloud server with Android and Apple iOS devices is by using the `mobile apps `_. -To connect to your Nextcloud server with the mobile apps, use the +To connect your mobile app to a Nextcloud server use the base URL and folder only:: example.com/nextcloud