Naming conventions
Hi, the current device list can be confusing because many devices have different ways to display and group:
- Some devices that have similar names are grouped, other are not:
- "Oneplus 3" and "Oneplus 3T" have different pages
- "Oneplus 5/5T" are in one page
- "Google Pixel and Pixel XL" are separated by "and", not "/"
- Pages with multiple devices might have multiple codenames. We are currently separating multiple codenames with , or -. Having multiple codenames will make it more difficult to automatically detect installer availability.
- Some devices might share the same codename (Oneplus 3 and Oneplus 3T have codename "oneplus3" in the installer), but they can't have the same filename since they are two separated pages.
- Some devices have codenames that include "_", "-" or ",". Currently they are mostly renamed to use only the "-" symbol as separator, but their real names include these symbols. Using the original name will improve the compatibility with installer autodetection, while using kebab case will improve path readability and solve #15 (closed) .
I suggest that we group as many devices as possible. We could use just one codename when devices have multiple codenames and use the same in the installer. The other codenames will just be set as aliases in the installer. For codenames that have underscores and special chars, we should use _ in the filename, but - in the page path, this will help installer autodetection and the page path readability. To further improve automation as requested in #15 (closed), we could set an external json API.