Nicco KunzmannFeb 27

@PeskyPotato Hi, i found your #icalendar tutorial:

https://blog.pesky.moe/posts/2025-01-02-create-icalendar/

We just released icalendar version 7 that makes it easier and uses properties and new() and I wonder: Would you like to add a tutorial like that into our official documentation?

Thanks!

#PythonIcalendar

Creating iCalendar files in Python

Schedules, events and alarms can be shared using the iCalendar data format regardless of the Calendar service or application like Google Calendar or Outlook. This format is defined in RFC 5545. Creating iCalendar files can be done in Python using the icalendar package. I’ve outlined a few example scenarios below. The package documentation has more details on usage. Installing the package pip install icalendar Other methods are available in the official documentation.

Show threadPeskyPotato

@niccokunzmann Absolutely! I'd definitely like to give it a go. I just took a look at version 7.x and like the move towards guiding the user towards creating valid calendars with the new class methods.

Where in the documentation would the tutorials live? Would it be a precursor to the How-to's and Reference Guide? If you already have it described in an issue I'd be happy to take a look.

Time to update to the new version and get my feet wet.

Feb 27 at 7:38pmWeb
Show threadNicco KunzmannFeb 28
@PeskyPotato Right now, #icalendar only has https://icalendar.readthedocs.io/en/stable/how-to/index.html with lots of how-to guides. Devs can use a tutorial and we do not have any. We follow https://diataxis.fr for good documentation. That makes a clear distiction. I think you can either open a PR and get feedbak or open an issue.
How to guides — icalendar 7.0.2 documentation