Hi @erika_antkowiak
Please find answers inline:
We have been unable to find any that help us fully understand how the naming convention of the new asset needs to be the same as the existing asset in AEM Assets to be added as a new version.
[KG]: To get a prompt for new version while uploading another asset, there are following rules:
1. New asset should be uploaded in the same folder as the older one for creating a new version
2. File Extension should be same
3. File Name should be same
Not meeting any of the above rules would make AEM believe that its a new asset and it will not prompt you for a new version.
I've recently uploaded a new asset with the same name as the existing asset into AEM Assets and it uploaded as a new separate asset in the system.
[KG]: Please check out above response
Is there a reason why this would happen? Would metadata have anything to do with it? Has anyone else had this experience or know of any documentation that covers the naming convention and versioning relationship in depth?
[KG]: As per OOTB functionality, as far as same filename+extension matches, it would detect the new asset upload as a candidate for new version. However, if you want to customize this behavior based upon binaries, you might need to enable duplicate detection config "Day CQ DAM Create Asset" OSGI config. This config depends upon dam:sha1 value(by default - can be changed to any other metadata asset property).
dam:sha1 is SHA 1 checksum value of the binary and if this is same for any two assets, it would not even check for Filenames and would take both assets as same and shall prompt you for new version.
https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/assets/admin/detect-duplicate-assets
Hope this helps