# Events

Events let people on a server plan a gathering: a date, where to meet, and who is coming. Events stay on the server
that holds them: only people with an account on it can see or join them, and they are never sent to other servers.

## Finding events

Choose "Events" in the navigation. "Upcoming events" lists the events you can see, the nearest first. On wide screens,
"Coming up" in the side column shows the next few, and a profile shows the events that person organizes. Nobody is
notified of a new event: you learn of one from these lists, from an invitation, or from a link someone shares.

Each event shows its date in your time zone. When the event is in another time zone, its own time and the place that
time zone is named after follow, such as "Sat, 9:00 – 11:00 PM (Tokyo)". An event whose organizers are still choosing
among candidate dates says "Date to be decided".

## Answering an event

Open an event and choose "Going", "Maybe", or "Not going" under "Your answer". The answer is saved at once, and you
can change it until the event starts. Answering "Going" or "Maybe" puts your name on the list of "Attendees", which
everyone who can see the event reads. When the event has a capacity and it is full, you can still answer "Maybe".

"Add to calendar (.ics)" saves the event as a file to import into your calendar app. It holds only the places you can
see.

## Choosing a date together

An event whose date is not set yet has a "Date poll": a table of the candidate dates, one row each, with how many
people "Can go", answered "Maybe", and "Can't go". Choose your answer in each row under "Your answer"; it is saved at
once, and you can change it until the date is set. Your name and answers show to everyone who can see the event, and
"Who answered" lists them for a date. You can answer "Going" under "Your answer" for the event once its date is set.

The organizer and the co-organizers add a date under "Add a candidate date", "Withdraw" one (a poll keeps at least
one), and choose "Set this date" to fix the event's date. The poll then stops taking answers, and the people who
answered it and the invited people are notified.

## Places

An event can have a place to meet in person, an online link (a stream or a meeting on another site), and a voice chat
room on this server. By default, the place in person and the online link are shown only to the attendees the
organizers approve; until then the page says that the place is shown to approved attendees, and the place is not sent
to your browser at all. A voice chat room is shown to everyone who can see the event, and opens when it starts:
from then on, "Join the voice chat room" on the event's page opens the room, where you join the call. If the room
could not open, the page says why.

Links to maps, online meetings, and the links in a description open in a new tab and name the site they go to: they
leave this server, which never checks them.

## The board

Each event has a board for what people need to know before and during it. The organizer, the co-organizers, and the
people who answered "Going" or "Maybe" see the event's page as two tabs, "Details" and "Board"; anyone else sees no
board at all. On the board, "Write on the board" opens the composer, and the post goes on the board alone: it is never
shown in a timeline, a profile, or search, never sent to other servers, and cannot be boosted or quoted. Posts on the
board are edited, deleted, replied to, favourited, and reacted to as any post. Who can write is the organizer's choice;
when you can't, the board says who can. Once the event is cancelled, or 7 days after it ends, the board is read-only.
A new post on the board notifies its readers, and the notification opens the board.

## Organizing an event

Choose "New event" on the list of events. The editor asks for:

- **Title**, and an optional **Description** (plain text; its links become clickable).
- **Time zone of the event**, **Starts**, and **Ends**. The times are those of the event's time zone, which starts as
  yours. An event lasts at most 7 days and starts within a year. To let people choose the date, pick "Ask people to
  answer candidate dates" and enter up to 20 candidates instead, each with its start and end.
- **Places**: "Meet in person" (a name, an address, and an optional map link) and "Online link" (a name and a URL),
  and **Who sees the place and the link**: "Only the attendees you approve" or "Everyone who sees the event". When
  voice chat is on and you can start rooms, "Voice chat room" opens a room for the event at its start, with **Who can
  speak without asking**.
- **Who sees the event**: everyone on this server, the organizer's followers, the people the organizer follows, mutual
  follows of the organizer, or only invited people. People you invite, and people who answered, always see it.
- **Who can write on the board**: only you, you and the co-organizers (the default), or everyone who reads the board.
- **Capacity**, how many people can answer "Going"; leave it empty for no limit.

On the event's page, the organizer and the co-organizers approve attendees ("Approve" and "Revoke approval"), invite
people of this server under "Invitations", and change the event with "Edit event". The organizer alone changes who
sees the event and who can write on the board, names up to three "Co-organizers", and cancels the event with "Cancel event", optionally with a reason
that the event then shows. A cancelled event stays readable but takes no more answers.

The server's moderators can cancel an event too; its page then says so, with their reason. Some servers let only some
people create events: when you may not, creating one says "You can't create events on this server".

If you answered "Going" or "Maybe", reminders come one day and one hour before the event starts. For every
notification of events (invitations, changes, cancellations, reminders, and new posts on the board), see [Notifications](https://mycroblog.dev/next/guide/notifications/).
