/gems command's examples on how to spend the gems should be adjusted, I also believe this issue has been brought up multiple times.
Since the command itself speaks about the limited availability of gems I believe it would be also good to optimize the examples as well.
Example 1 recommends a 3rd academy slot, however for a new player this slot will be pretty much dead as skill books will be a bigger issue,
therefore it would be better to drop it from the recommendation and add the remain gems to dock space.
Example 2 is aimed at active players according to its description however due to the way AL fleets are set up multiples of 6 are ideal for fleet's morale recovery and consequently increasing active playtime,
3 slots + 2nd floor(for dedicated morale)/4 slots + 2nd floor (leeway for inactive passive xp ships) would be here a generally better idea then the provided example,
not to mention the increased dock space which is a QoL an active player would appreciate.
Example 3 is the heavy dock focused upgrade however here as well the 2nd floor upgrade which costs the same as 4th dorm slot would be more beneficial for same reasons mentioned above.
All in all all things point that the most optimal setups are between 3-4 dorm slots + 2nd floor + rest in dock.
IMO this should be the only example provided for people who want a template right away and the note below to be adjusted and then leave it to the player's discretion if they would like a different customization that matches their needs.
PS: if memento bonus could be adjusted as well and some fluff text to be cut in order to not clutter the chat that would be great, as some information could be just changed to a redirect to wiki instead of being it written in the command.
the POI are the total gems possible to be earned, their limited availability, their sources(which can be linked), the recommended example setup and the customization disclaimer.