Doco - update the right index this time, and only maintain one.

The doco needs cleaning up as we go along,  We should keep the bbcode
despite the failed experiment because identity tags are just too useful
to be without.