Note that there's a somewhat hidden positive and a similar negative to these armour articles. Upside: the paperdoll can be reused for in-combat MMB enemy display and Ufopedia access. Downside: the armour articles use a different palette than Battlescape (Battlepedia, I think?), so your paperdoll might look fine in combat and suck in the pedia. You can either rework the image or change the palettes to conform, but it's a mildly involved task.
Articles are ordered by listOrder (but go into their respective sections, which can change that order), and sections are ordered by... their order of appearance in the ruleset, I think?
XCF entries are put into an 'Enemies and Allies' section, which is largely 'Alien Creatures' plus all other units that can appear in battle, from civilians to shadowy cults, military units and cryptids.
Also, you can move some info from the nerdpedia (INFO button) to the text if you wanted. That's how Piratez does things. Stuff like night vision, camo values, melee dodge, etc.
It's a separate article with its own article type, different from the general text/image type used by interrogations/autopsies.
Multiple armours can be handled in different ways. Solarius uses the base Sectoid (Soldier) and provides a short text that hints at the abilities of more advanced aliens. You could have a separate article for each armour if you wanted, though, or a combination of the two.
Also, you can move some of the info from the nerdpedia (INFO button) to the text if you wish. That's how Piratez does it. Stuff like night vision, camo, melee dodge, etc.