Skip to content

Commit

Permalink
docs: 📚️ add end-user and getting-started guide
Browse files Browse the repository at this point in the history
  • Loading branch information
josegonz115 committed Jun 21, 2024
1 parent c48f992 commit d071259
Show file tree
Hide file tree
Showing 3 changed files with 80 additions and 2 deletions.
65 changes: 64 additions & 1 deletion pages/special-projects/centralized-calendar/end-user.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,72 @@ import { Callout } from "nextra/components";

<Callout type="info">
This page is intended for members of other ICS organization to provide information on how to
participate in the Centralized Calendar project.
participate in the ics-centralized-calendar project.
</Callout>

{/* Include a breif introduction of what is Centralized Calendar Project is and steps to get a the required Google Calendar URL. */}

## Introduction

The `ics-centralized-calendar` project is an easy to use API meant to provide centralized access to all ICS calendars, offering options for selecting specific clubs and output formats (ICS or JSON).

## Steps to Add Your Google Calendar URL

To participate in the ics-centralized-calendar project, follow these steps to share your Google Calendar URL:

1. **Open Google Calendar:**

- Go to [Google Calendar](https://calendar.google.com).

2. **Access Calendar Settings:**

- On the left sidebar, hover over the calendar you want to share.
- Click on the three vertical dots that appear and select "Settings and sharing."

3. **Get the Shareable Link:**

- Scroll down to the "Access permissions for events" section.
- Check the box that says "Make available to public."
- Scroll further down to the "Integrate calendar" section.
- Copy the "Public address in iCal format" link.

4. **Submit Your Calendar Link:**
- Send the copied calendar link to our project team leads ([Alex](https://github.com/alexanderl19), [Eddy](https://github.com/ecxyzzy)).

<Callout type="tip">
Remember to make sure your calendar is set to public so that we can access and integrate your
events.
</Callout>

{/* Include a breif FAQ with information on how event updates work. */}

## FAQ

### How do event updates work?

Once your calendar link is submitted and integrated into the ics-centralized-calendar, your events will be automatically updated every 6 hours. This ensures that any new events or changes to existing events that have not happened yet are reflected in the ics-centralized-calendar quickly.

### What event information is required?

Every event should have the following fields for best clarity and organization, these fields are usually required by default when creating an event in Google Calendar:

- **Title:** A clear description of the event.
- **Date and Time:** A start and end time that is input through the google calendar GUI.
- **Description:** Include details such as location, agenda, and contact information.

### How can I make changes to my events?

Simply update your events in your Google Calendar. The changes will be reflected in the ics-centralized-calendar during the next update cycle.

### How do I change or remove my club's calendar from the centralized calendar?

Contact our project leads([Alex](https://github.com/alexanderl19), [Eddy](https://github.com/ecxyzzy)) to change or remove your calendar URL from the ics-centralized-calendar.

### Who do I contact for support?

If you have any questions or need assistance, contact our project leads ([Alex](https://github.com/alexanderl19), [Eddy](https://github.com/ecxyzzy)).

<Callout type="info">
By participating in the ics-centralized-calendar project, you help create a more organized and
informed ICS community. Thank you for your contribution!
</Callout>
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,14 @@ aws_access_key_id = <YOUR_ACCESS_KEY_ID>
aws_secret_access_key = <YOUR_SECRET_ACCESS_KEY>
```

### Setup postgres environment variable

You can request database credentials from you project lead or you can just create your own database server on your local machine for local development purposes. Whichever you choose, you will need to set the `DATABASE_URL` environment variable in a `.env` file in the root of the project. The `.env` file should look like this:

```
DATABASE_URL=postgres://yourusername:yourpassword@localhost:5432/calendar
```

</Steps>

## Commands
Expand Down
9 changes: 8 additions & 1 deletion pages/special-projects/centralized-calendar/index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,10 @@
# Centralized Calendar

<!-- Add a breif description of what the centralized calendar is and it's goals. -->
The ics-centralized-calendar project is designed to enhance collaboration and cohesiveness within the ICS community. It is an API that aggregates calendar information from participating ICS clubs and provides easy access to events in both ICS and JSON formats.

## Goals

- **Foster Community:** Strengthen the sense of community within ICS.
- **Enhance Cohesiveness:** Promote transparency and cooperation between clubs.
- **Inform Students:** Provide ICS students with clear and accessible information about club events.
- **Streamline Event Viewing:** Simplify the process of viewing events from each club.

0 comments on commit d071259

Please sign in to comment.