New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Provide documentation #336

Open
pmocek opened this Issue Jun 14, 2018 · 4 comments

Comments

Projects
None yet
4 participants
@pmocek

pmocek commented Jun 14, 2018

It would be helpful to have some user documentation for this application. I am interested in using it, but cannot determine from the README even very basic information about it (e.g., Is this a CalDAV client? Can it send invitations and event updates via e-mail?).

@jspricke

This comment has been minimized.

Member

jspricke commented Jun 15, 2018

great idea. As a developer most of it seems obvious, so it would be great if you could draft it and we can complete it together.
Regarding your questions, a CalDAV client is not included, Etar relies on the calendar provider provided in Android. To sync using CalDAV, I recommend DAVDroid (you can get it for free from F-Droid: https://f-droid.org/de/packages/at.bitfire.davdroid/). Invitations via mail are implemented, but I'm unsure if it currently works. See #163 for issues with it.

@pmocek

This comment has been minimized.

pmocek commented Jun 15, 2018

I have written software since the 1980s, and this is not obvious to me.

@jspricke, I suspect you are making some assumptions about people's familiarity with the specifics of Android. I came across this software because it is listed by Restore Privacy as an alternative to Google Calendar. It would be useful to know right away, for example, that using Etar-Calendar will still result in connections to Google's calendaring server. As I understand what you wrote, this is just an alternative Google Calendar client for Android. I hoped to find something I could configure to use with NextCloud, my existing Fastmail account, etc., avoiding Google altogether.

@ramack

This comment has been minimized.

ramack commented Jun 15, 2018

no, you don't get it right... On Android there are "Calendar providers". Those can be such calendars which are synched to a cloud service or local calendars. Basically any APP could provide a calendar. Those "provided" calendars can be used by Etar and you can even configure in Etar which ones are to be shown and when adding an event to which calendar it should be added.

For the cloud-synched calendars you are free again. You might choose to use a google calendar, but you can also use any other public Caldav-server or even host your own (which would be the only way to keep full control over your data and still have ONE calendar usable from different devices.) To sync the calendar to some server you need yet another app, e. g. DAVdroid.

@Gitsaibot

This comment has been minimized.

Contributor

Gitsaibot commented Jun 15, 2018

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment