Update and improve the Lua docs

Explain the mw.wikibase.entity.claimRanks table and
avoid long lines in source tags.

Change-Id: If16030bb0a2be10aa74b974f57da6b88cecf7dfc
Merge "Update and improve the Lua docs"