Roundcube migration guide

pages/02.tutorials/02.Cloud/04.Apps/01.Tasks/01.Web/docs.en.md

@@ -1,11 +1,11 @@
 ---
-title: Tasks: Web
+title: 'Tasks: Web'
 published: true
 visible: false
 updated:
-        last_modified: "July 2019"
+        last_modified: "September 2020"
         app: Nextcloud
-        app_version: 15
+        app_version: 18
 taxonomy:
     category:
         - docs
@@ -17,37 +17,77 @@ page-toc:
     active: false
 ---
 
-## Tasks on web-interface
-
-The Tasks app allows you to add and delete tasks. A task could be a meeting date reminder, a job that needs to be done, a personal or a group activity and a lot of other things.<br> In this howto we'll see how to create, edit and share tasks.
+# Tasks
 
 ![](en/main.png)
 
-#### Adding a new task
-Click in the item box and enter the name of the new task.
+The **Tasks** app allows you to add and delete tasks, edit their title, description, start and due dates and mark them as important. A task could be a meeting date reminder, a job that needs to be done, a personal or a group activity and a lot of other things.
 
-![](en/add_task_box.png)
+In this short howto we'll see how it works.
+
+# Adding a new task
+To start, click on **+ Add list...**, write the name of your new list of tasks and press enter.
+
+![](en/add_task.gif)
 
 Once you did it, a new section will show at the right.
 
-![](en/add_tasks.png)
+![](en/add_tasks_window.png)
 
-Here you can set:
+Type in the name of the new task you want to add and then press enter. Click on the three-dots icon at the right if you want to add subtasks.
 
-- **The start date and due date**
+![](en/add_tasks.gif)
 
-![](en/add_tasks_date_01.png) ![](en/add_tasks_date_02.png)
-By clicking on the Start/Due option you can set the day and the hour of it. You can also set the task as an all day activity
+## Tasks options
+Click on the task or subtask title to access the options.
 
+![](en/tasks_options.png)
 
-- **The priority of the task**
+Here you can:
 
-![](en/add_tasks_priority.png)
-By moving the bar, you can set the priority level from 1 to 9.
+- **Set the start date and due date**<br>
+By clicking on the Start/Due option you can set the day and the hour of it.
 
-- **Set and edit the progress level of the task**
+  ![](en/start_due_date.gif)
 
-![](en/task_completed.png)
-By moving the bar, you can set the task progress from 0% to 100%.
+  You can also set the task as an all day activity.
 
-- **Tags**
+  ![](en/all_day.png)
+
+- **Assign / change the tasks list**<br>
+  You can change / assign a task or sub-task to different lists or calendar. Just select one from the drop-down menu and the tasks will change to the new one.
+
+  ![](en/assign_list.gif)
+
+- **Select a classification**<br>
+  You can assign the task list to a previously created calendar and choose how it should be shown.
+
+  ![](en/show.png)
+
+- **Select a status**<br>
+  Select if the task **needs an action**, if it is **in process**, **completed** or **cancelled**.
+
+  ![](en/status.gif)
+
+- **Assign a priority level to the task**
+  By moving the bar, you can set the priority level where 1 to 4 is **High**, 5 is **Medium** and 6 to 9 is **Low**.
+
+  ![](en/priority.gif)
+
+- **Set and edit the progress level of the task**<br>
+  By moving the bar, you can set the task progress from 0% to 100%.
+
+  ![](en/progress.gif)
+
+- **Categories and Comments**<br>
+  Assigning categories and adding comments can be very useful when working in a group. Click on **Select categories**, select or create one and press Enter. To write a comment, simply type it in the box.
+
+  ![](en/categories_comments.gif)
+
+  When the task has a category assigned or a comment added, you can see it in the description, next to the title.
+
+  ![](en/categories_comments.png)
+
+- Finally, at the bottom of the tasks details you will see a bar with the delete and info options.
+
+  ![](en/info.png)

pages/02.tutorials/02.Cloud/04.Apps/01.Tasks/02.Desktop/docs.en.md

@@ -1,9 +1,9 @@
 ---
-title: Tasks: Desktop
+title: 'Tasks: Desktop'
 published: true
 visible: false
 updated:
-        last_modified: "July 2019"
+        last_modified: "October 2020"
 taxonomy:
     category:
         - docs
@@ -15,13 +15,13 @@ page-toc:
     active: false
 ---
 
-## Tasks desktop Integration
+## Tasks on the desktop
 
-You can read the tutorials below in order to get your **Tasks** synchronized via a multi-platform desktop client.
+There are several ways you can sync and work with **Nextcloud Tasks** from your desktop. Below you will find some tutorials to get it.
 
-- [Thunderbird: Calendar / Contacts / Tasks sync](/tutorials/cloud/clients/desktop/multiplatform/thunderbird-calendar-contacts)
+### Multi-platform desktop clients
+ - [Thunderbird: Calendar / Contacts / Tasks sync](/tutorials/cloud/clients/desktop/multiplatform/thunderbird-calendar-contacts)
 
-Alternatively, you can use and set up the desktop integration.
-
- - [GNOME: Desktop Integration](/tutorials/cloud/clients/desktop/gnu-linux/gnome-desktop-integration)
- - [KDE: Desktop Integration](/tutorials/cloud/clients/desktop/gnu-linux/kde-desktop-integration)
+### GNU/Linux
+ - [GNOME Desktop Integration](/tutorials/cloud/clients/desktop/gnu-linux/gnome-desktop-integration)
+ - [KDE Desktop Integration](/tutorials/cloud/clients/desktop/gnu-linux/kde-desktop-integration)

pages/02.tutorials/02.Cloud/04.Apps/01.Tasks/03.Mobile/docs.en.md

@@ -1,9 +1,9 @@
 ---
-title: Tasks: Mobile
+title: 'Tasks: Mobile'
 published: true
 visible: false
 updated:
-        last_modified: "July 2019"
+        last_modified: "October 2020"
 taxonomy:
     category:
         - docs
@@ -15,9 +15,9 @@ page-toc:
     active: false
 ---
 
-## Tasks integration on mobile devices
+## Tasks on mobile devices
 
-To set up and sync your **Tasks** throught a mobile client see the tutorial below:
+To set up and sync your **Tasks** on your mobile you can read some of the tutorials below:
 
 ### Android
 - [DAVx⁵ / OpenTasks](/tutorials/cloud/clients/mobile/android/calendars-contacts-and-tasks)

pages/02.tutorials/02.Cloud/04.Apps/01.Tasks/docs.en.md

@@ -1,5 +1,5 @@
 ---
-title: "Cloud Apps: Tasks"
+title: 'Apps: Tasks'
 published: true
 visible: false
 indexed: true
@@ -17,12 +17,13 @@ page-toc:
 ---
 
 # Tasks
+**Tasks** is a **Nextcloud** app that allows to create, edit, share tasks and keep them synchronized on your devices. To learn how to set it up and use it, you can see the following tutorials.
 
 ### [Web interface](web)
-- Creating and configuring tasks
+- Creating and configuring tasks from the web browser.
 
 ### [Desktop clients](desktop)
-- Desktop clients and applications for organizing and synchronizing tasks
+- Desktop clients and applications for organizing and synchronizing tasks.
 
 ### [Mobile clients](mobile)
-- Mobile clients and settings for organizing and synchronizing tasks
+- Mobile clients and settings for organizing and synchronizing tasks.

pages/02.tutorials/02.Cloud/04.Apps/02.Calendar/01.Web/docs.en.md

@@ -1,143 +1,178 @@
 ---
-title: "Calendar: Web"
+title: 'Calendar: Web'
 published: true
 indexed: true
 visible: false
 updated:
-        last_modified: "July 2019"
+        last_modified: "October 2020"
         app: Nextcloud
-        app_version: 15
+        app_version: 19
 taxonomy:
     category:
         - docs
     tags:
+        - apps
         - calendar
         - cloud
 page-toc:
     active: true
 ---
 
-# Using the Calendar app via web interface
+# Using the Calendar app
+Login to the **Cloud** and access your calendar app by clicking the *calendar icon* in the top bar.
 
-You can access your calendar app by pressing the ![](en/calendar_top_icon.png) {.inline} icon in the top bar.
-*Left-bar* in the calendar window gives you an overview of your calendars, their options and general settings.
+![](en/calendar_app.png)
+
+The *left-pane* in the calendar window gives you an overview of your calendars, their options and general settings.
 
 ![](en/calendar_main.png)
 
+# Create a Calendar
+To create a new calendar just click **New calendar**. A small prompt will appear where you can type the name you want to give to this new calendar. Then press the ![](en/arrow.png) arrow icon.
 
-## Create Calendar
-To create a new calendar in this options panel press "*create calendar*"
-A small prompt will appear where you can type the name you want to give to this new calendar and select a color for it.
-Then press "*create*".
+![](en/calendar_create.png)
 
-![](en/calendar_add_new.png)
+You can create multiple calendars for different purposes (work, activism, etc.) by repeating this process.
 
-You can create multiple calendars for different purposes (work, activism, etc.) by repeating this process. If you do that, you can use different colors to set them apart (last icon is the color picker which allows you to choose any color you want![](en/calendar_colorpick_icon.png)).
+![](en/repeating.png)
 
-![](en/calendar_list.png)
+## Calendar options
+On the left panel, you will see your calendars listed. By clicking on the three dots icon to the right of a calendar, you will access the options menu from where you can:
+
+- Edit the calendar name
+- Edit its color (useful if you have many calendars)
+- Copy private link to get the calendar URL to sync it with other devices
+- Download it (in which case a .ics will be created for that)
+- Delete it
+
+ ![](en/calendar_options.png)
+
+## Sharing a calendar
+To share a calendar click on the *share icon* ![](en/share_icon.png), this will allow you choose how it will be shared.
+
+![](en/calendar_sharing.png)
+
+Basically there are two sharing methods:
+
+  * **Public link**
+
+  ![](en/calendar_sharing_link.png)
+
+  A public link make the calendar viewable (read-only) to external users. Once the link is generated you can access some options related to it, such as:
+    - Send the link via email
+    - Copy the subscription link to the calendar
+    - Copy the embedding code (it provides an HTML iframe in case you want to embed the calendar somewhere)
+    - Delete the link
+
+  * **User or groups**
+
+  ![](en/calendar_sharing_edit.png)
+
+  Enter the name of a user or group and select whether thay can edit the calendar or not. **When sharing a calendar with edit permission, users with whom the calendar is shared will be able to create new events into the calendar as well as edit and delete existing ones**.
+
+## Importing a calendar and other settings
+
+You can tranfer any calendar and their respective events between **Nextcloud** instances by downloading and importing them from the **Settings & import** menu at the bottom left of the calendar window.
+
+![](en/calendar_settings_import.png)
+
+Click on **Import calendar** and select the calendar file (.ics) you want to upload.<br>
+In this menu you will also find some other options related to a selected calendar that are self-explanatory.
+
+# Creating an event
+To create a new event in your calendar just click on the date of the event. A window will appear with very basic options such as **Event title**, choose which calendar to link it to, if it is an **All day** event or set the time range of it.
+
+![](en/event_options_01.png)
+
+Remember that if you have more than one calendar, you must select to which one the event correspond, so that you avoid events/tasks ending up on the wrong calendar.
+
+![](en/select_cal.gif)
+
+You can access more detailed options by clicking on the **More** button. A panel will appear on the right side, where you can add more complete information of the event.
+
+![](en/event_options_panel.png)
+
+In this panel you will find and be able to set and edit the following options:
+
+* **Details**
+  - Add an **Event title**
+
+    ![](en/title.gif)
+
+  - Select to which calendar the event goes to
+
+    ![](en/sel_cal.gif)
+
+  - Set the **Start/End** date and time
+
+    ![](en/date.gif)
+
+  - Select if it is an **All day** event
+
+  - **Add a location**
+
+  - **Add a description**
+
+  - Set the overall **status** of the event (Confirmed/Tentative/Cancelled)
+
+  - Set the visibility of the event when the calendar containing it is shared (Show full event/Show only busy/Hide the event)
+
+  - Set how the event should be taken into account when calculating Free/Busy information
+
+  - Add a **Category** to help you structure and organize your events
+
+  - Edit the color
+
+    ![](en/details.gif)
+
+* **Attendees**<br>
+    You can invite people to an event by selecting the **Attendees** option and typing their email addresses, usernames (if they are other **Cloud** users), contacts in your addressbooks or even rooms.
+
+  ![](en/attendees.png)
+
+  You can also set the level of participation per-attendees, or disable email confirmation for a specific attendee.
+
+  ![](en/attendees_level.png)
+
+  When you add other **Cloud** users to an event, you can access their **Free/Busy** information (if it’s available). This is very useful to determine when is the best time frame for your event.
+
+  ![](en/free_busy.png)
+
+  **NOTE**: Remember that only the calendar owner can send out invitations. The attendees cannot do that, whether they have write access to the event’s calendar or not.
+
+* **Reminders**<br>
+  You can set a reminder for the event by pressing on **Reminders** tab and then **+ Add reminder**.
+
+  ![](en/reminders.png)
+
+  There are two notification methods:
+
+  * Email notification
+  * Nextcloud notification
 
 
-## Delete, edit, Download calendar.
-On the left panel, you will see your calendars listed. To the right of each calendar you will find a "more" button where you can:
+  You can set reminders at a time relative to the event or at a specific date.
 
-- rename your calendar,
-- download it
-- get a url link to sync it with other devices
-- delete your calendar.
+  ![](en/reminder_options.png)
 
-![](en/calendar_edit1.png)
+  ![](en/reminder_options_date.png)
+
+  **NOTE**: Only the calendar owner and people or groups with whom the calendar is shared with write access will get notifications.
 
 
-## Create an event
-You can create a new event in your calendar by clicking in the calendars *main window* simply on the day of the event. A panel will appear on the right side, where you can fill with the information of the event.
+  * **Repeat**<br>
+  If this is a recurring event you can set it to happen every day, week, month or year. Specific rules can also be added to set which day of the week the event happens or more complex rules, for example, every second Tuesday of each month.
 
-![](en/calendar_edit_menu.png)
+  You can also tell when the recurrence ends.
 
-In this panel you can specify:
-
-  - event title
-  - start and end date
-  - start and end time
-  - if it's full day event or not
-  - event location
-  - event description
-
-![](en/calendar_edit_menu2.png)
-
-If you have multiple calendars, in your Disroot calendar app, you need to select to which calendar the event goes to. You can do that below the event title field.
-
-![](en/calendar_edit_menu3.png)
-
-You can set a reminder for the event by pressing "Reminders" and "Add"
-
-![](en/calendar_edit_menu4.png)
-
-You can select what type of reminder you want:
-
-* audio
-* email
-* pop up
-
-And set the time for it.
-
-Just press the reminder you added and the options will show up.
-
-![](en/calendar_edit_menu5.png)
-
-You can also set if this is a repeating event or not. Just check *repeating* options.
-
-![](en/calendar_edit_menu6.png)
-
-
-## Invite people to events
-
-You can also invite people to your event via email by:
-
-* pressing "Attendees"
-* Filing the field with the persons email address
-* press enter
-
-![](en/calendar_edit_menu7.png)
-
-The people you invite will receive an automaticly generated email with the invitation. Any changes you make to the event will be automatically sent by email to the person you've added.
-
-When you're done with everything, just press create at the end of the panel, and your event will appear on the screen
+  ![](en/repeat.png)
 
 
 ## Edit or delete events
-To edit or delete an event you've created, just click the event on your screen, edit it and then press "update".
-To delete it, you will find the big red button.
+To edit an event you've created, click the event on your screen. This way you can edit the title, the calendar to which it belong to and the date.
 
-![](en/calendar_edit_menu8.png)
+![](en/edit_event.png)
 
+By clicking on the **More** button you can do a more detailed edition and access to the event **Download** and **Deletion** options. Just click on the three dots menu at the right of the event title.
 
-## Share calendars
-You can share your calendars, either with another disroot user, via email, or public link.
-
-To share with another Disroot user:
-
-* press the the share button on the right of your calendar name
-* type the username of the Disroot user that you want to share the calender with
-* press enter.
-
-![](en/calendar_share_menu1.png)
-
-To share calendars via email or public link:
-
-* go to the same "shared" option
-* select "Share link"
-* fill the email address field with the email of the person you want to share your calendar with
-* press enter
-* to just get the link press the chain symbol next to the mail envelope symbol
-
-![](en/calendar_share_menu2.png)
-
-
-## Import calendars
-If you have a ICS file with a calendar to import, go to disroot calendar app then go to "Settings & Import" on the lower left corner of the screen.
-
-![](en/calendar_import_menu1.png)
-
-And select import calendar option.
-
-![](en/calendar_import_menu2.png)
+![](en/event_edit_options.png)

pages/02.tutorials/02.Cloud/04.Apps/02.Calendar/docs.en.md

@@ -1,5 +1,5 @@
 ---
-title: "Cloud Apps: Calendar"
+title: 'Apps: Calendar'
 published: true
 visible: false
 indexed: true
@@ -15,6 +15,7 @@ page-toc:
 ---
 
 ## Calendar
+The **Calendar** app is a user interface for **Disroot Cloud**'s CalDAV server and it works like many other calendar applications allowing synchronization of events, tasks and more from various devices with your **Cloud**.
 
 ### [Web interface](web)
 - Creating and configuring calendars

pages/02.tutorials/02.Cloud/04.Apps/03.Contacts/docs.en.md

@@ -1,5 +1,5 @@
 ---
-title: Cloud Apps: Contacts
+title: 'Apps: Contacts'
 published: true
 visible: false
 indexed: true

pages/02.tutorials/02.Cloud/04.Apps/04.Notes/docs.en.md

@@ -1,5 +1,5 @@
 ---
-title: Cloud Apps: Notes
+title: 'Apps: Notes'
 published: true
 visible: false
 updated: