This is a project that aims to finish item descriptions in Arcanum, because why not?
The major goal of this mod is to go through every single item in the game and put at least a basic description, if not proper game data.
In the case of armors and weapons, item stats always go first, therefore, before any descriptors.
Otherwise, flavor text is fine too. It's definitely better than nothing!
As for immersion breaking text: I would say permitted for quest items, but try to tie them to the character's knowledge about the quest.
Play the game and use the mod to pass feedback or ideas from the game level
https://github.com/SCARaw/Arcanum-Item-Description-Project/issues - if you have something to add, but not a lot
or fork the whole thing and edit-in your changes and submit contributions
or use Discord for Arcanum: https://discord.com/invite/KT7sRzY and pass me your edit or whats not :)
The release contains the best version for a time.
Nothing is stopping you from taking raw files from the project and using it in your own game, too.