core: Fix gtk-doc for source-tags

They were referred to as "tags" in some places, and "source-tags"
in others.
core: Add documentation for source-tags

Explain usage and commonly used tags.

https://bugzilla.gnome.org/show_bug.cgi?id=724019