refactor test_create_to_ical from test_encoding to test_examples.py

[jacadzaca]

Refactor test_create_to_ical, test_create_event_simple and test_unicode_parameter_name from test_encoding along the lines of #374, move them to test_examples.py.

[niccokunzmann]

The docstring does not explain anything.

[niccokunzmann]

I do not know what to do with it. I would need to reconnect to the value of refactoring this. It seems to be an ok refactoring. It can be merged as I have nothing against it except from the docstring. I mean in short: it does not hurt and I have nothing against it.

[jacadzaca]

I think creating a single file with tests that showcase practical icalendar usage is important, so as to expand the examples section. We know that documentation is somewhat lacking in examples, because there have been issues where people ask how to do X, e.g. #317, #341, #317, #421, #425.

[niccokunzmann]

@jacadzaca, could you create an issue for this? I would find it nice if

1. The documentation with the examples shows up on readthedocs
2. That the code is actually running.

As a suggestion, one could use doctest
I do think that this issue is a very good first-timer issue because of its repetitiveness, the simplicity and the range of skills you build up while contributing to it. I would really love to see it. If you do not like to make this issue, I will do it.

What do you think?

[jacadzaca]

I'm off to bed now, but I'll gladly file it tomorrow :)

[jacadzaca]

@niccokunzmann is #443 OK?

[niccokunzmann]

I commented. Could I edit it to make it more beginner friendly?

[niccokunzmann]

So, yes, thanks that is quite a good start. I could not have listed all the issues.

[jacadzaca]

Feel free to edit it :)