Add a note to CameraGeometry docs about from_name()

[kosack]

Note that from_name() is not guaranteed to correspond with event data.

Closes #2484

[maxnoe]

camera_types is a set, you can't Index it

[maxnoe]

Can we (also?) raise an actual code warning?

i.e.:

warnings.warn(".from_name methods use pre-defined data that is likely different from the data being analyzed. Access instrument information via the SubarrayDescription instead.")

[maxnoe]

The docs failure here is real and due to the changes made

[maxnoe]

@kosack, I added the actual warning now to those methods and made it fail the CI if it occurs unexpectedly.

It's your PR, so you cannot really approve, but please have a look.

@Tobychev please review again :)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.54%. Comparing base (163b543) to head (a9cf92f).
Report is 11 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2485   +/-   ##
=======================================
  Coverage   92.53%   92.54%           
=======================================
  Files         235      236    +1     
  Lines       20063    20089   +26     
=======================================
+ Hits        18565    18591   +26     
  Misses       1498     1498           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.