@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
Write a basic Calendar user guide
Summary:
Ref T11809. Roughly documents most of the tricky/unintuitive stuff.
Also fixes a bug with "Make Recurring" with no "Until" date.
Test Plan: Read document.
Reviewers: chad
Reviewed By: chad
Maniphest Tasks: T11809
Differential Revision: https://secure.phabricator.com/D16792
+81
-1
+6
-1
src/applications/calendar/xaction/PhabricatorCalendarEventUntilDateTransaction.php
+6
-1
src/applications/calendar/xaction/PhabricatorCalendarEventUntilDateTransaction.php
···
8
8
public function generateOldValue($object) {
9
9
$editor = $this->getEditor();
10
10
11
-
return $object->newUntilDateTime()
11
+
$until = $object->newUntilDateTime();
12
+
if (!$until) {
13
+
return null;
14
+
}
15
+
16
+
return $until
12
17
->newAbsoluteDateTime()
13
18
->setIsAllDay($editor->getOldIsAllDay())
14
19
->toDictionary();
+75
src/docs/user/userguide/calendar.diviner
+75
src/docs/user/userguide/calendar.diviner
···
9
9
IMPORTANT: Calendar is a prototype application. See
10
10
@{article:User Guide: Prototype Applications}.
11
11
12
+
Calendar allows you to schedule parties and invite other users to party with
13
+
you. Everyone loves to party. Use Calendar primarily for partying.
14
+
15
+
16
+
Reminders
17
+
=========
18
+
19
+
Calendar sends reminder email before events occur. You will receive a reminder
20
+
if:
21
+
22
+
- you have marked yourself as **attending** the event;
23
+
- the event has not been cancelled; and
24
+
- the event was not imported from an external source.
25
+
26
+
Reminders are sent 15 minutes before events begin.
27
+
28
+
29
+
Availability
30
+
============
31
+
32
+
Across all applications, Phabricator shows a red dot next to usernames if the
33
+
user is currently attending an event. This provides a hint that they may be in
34
+
a meeting (or on vacation) and could take a while to get back to you about a
35
+
revision or task.
36
+
37
+
You can click through to a user's profile to see more details about their
38
+
availability.
39
+
40
+
41
+
Importing Events
42
+
================
43
+
44
+
You can import events from email and from other calendar applications
45
+
(like Google Calendar and Calendar.app) into Calendar. For a detailed
46
+
guide, see @{article:Calendar User Guide: Importing Events}.
47
+
48
+
49
+
Exporting Events
50
+
================
51
+
52
+
You can export events from Calendar to other applications by downloading
53
+
events as `.ics` files or configuring a calendar subscription.
54
+
55
+
Calendar also attaches `.ics` files containing event information when it sends
56
+
email. Most calendar applications can import these files.
57
+
58
+
For a detailed guide to exporting events, see
59
+
@{article:Calendar User Guide: Exporting Events}.
60
+
61
+
62
+
Recurring Events
63
+
================
64
+
65
+
To create a recurring event (like a weekly meeting), first create an event
66
+
normally, then select {nav Make Recurring} from the action menu and configure
67
+
how often the event should repeat.
68
+
69
+
**Monthly Events on the 29th, 30th or 31st**: If you configure an event to
70
+
repeat monthly and schedule the first instance on the 29th, 30th, or 31st of
71
+
the month, it can not occur on the same day every month because some months
72
+
do not have enough days.
73
+
74
+
Instead, these events are internally scheduled to occur relative to the end
75
+
of the month. For example, if you schedule a monthly event on the 30th of a
76
+
31 day month, it will occur on the second-to-last day of each following month.
77
+
78
+
**Complex RRULEs**: Calendar supports complex RRULEs internally (like events
79
+
that occur every-other Thursday in prime-numbered months) but does not
80
+
currently have a UI for scheduling events with complex rules.
81
+
82
+
Future versions of Calendar may improve support for complex scheduling by using
83
+
the UI. In some cases, a partial workaround is to schedule the event in another
84
+
application (which has more complex scheduling controls available) and then
85
+
import it into Calendar.
86
+
12
87
13
88
Next Steps
14
89
==========