Refacting the vala doc

[nda-cunh]

add missing documentation and exemple

[lw64]

for beginners I think just print() is better. Then there can be a note explaining that in actual projects people prefer stdout.printf() and why, maybe in the section also where the different main() variants are explained

[nda-cunh]

It's fine with me, I agree, to show the world that à la is easy to write! 😎

[colinkiama]

You've done amazing work however, the title suggests that there's only refactoring going on. I see that some brand new content is being added too.

Once you've pushed all the changes here that you want to do, can you split this merge request into multiple smaller merge requests please?

This way, we can get the content reviewed and merged in much faster! ;)

[nda-cunh]

You've done amazing work however, the title suggests that there's only refactoring going on. I see that some brand new content is being added too.

Once you've pushed all the changes here that you want to do, can you split this merge request into multiple smaller merge requests please?

This way, we can get the content reviewed and merged in much faster! ;)

I'm terrible at choosing names for MR titles! I haven't finished yet, so I'm going to add some pages on partial class
can you help me find another name?

[colinkiama]

Your commit titles can be used as the pull request titles.