Files
advanced-camera-card/docs/support.md
T
Dermot Duffy cc376a8be1 feat: Rename the card to advanced-camera-card (#1873)
Whilst the Frigate support in this card is the best among camera
engines, the name incorrectly suggests that Frigate is a requirement.
Instead, to broaden the appeal, change to more camera agnostic name.
This does not suggest any change in priority, role or support for
Frigate.

This change is likely to be bug prone, due to the size of the rename --
the code contains 1500+ references to "Frigate" most of which make sense
to rename, some which do not, all of which needed human assessment.

- Closes #1298


BREAKING CHANGE: References to `frigate-card` in all kinds of
configuration need to be updated to `advanced-camera-card`. An automated
config upgrade should take care of the majority of usecases (click `Edit
-> Upgrade -> Save`), though may not be perfect.
2025-02-06 19:32:32 -08:00

2.6 KiB

Common Support Answers

Diagnostics Missing In Issue

You have filed an issue against the card, but failed to include the required diagnostics and/or missed this warning in the new issue template:

<!-- =================================================================
***               PLEASE DO NOT IGNORE THIS TEMPLATE
***
*** This is the smallest amount of information needed to help you!
====================================================================== -->

Without the diagnostic data, it is substantially more time consuming to try to "guess" the basic parameters necessary to help you. I really want this card to incrementally improve, and I think time is better spent working on reproducible issues or new features, than guessing what versions/options you are using. The new issue template asks for the minimum possible information to support you:

  • Diagnostics: On the card, hold down the Iris (default) menu button for a few seconds then paste the diagnostics into the issue between the backticks.
  • Description of the problem: I need to understand the issue in sufficient detail.

This seems like a reasonably low bar for help, so if your issue gets closed for not providing this information, please do not be offended. I want to help, just need to prioritize my limited development time well. Feel free to re-open your issue, providing the requested information.

Misconceptions About Open Source

  • The fixes aren't fast enough!
  • The features aren't good enough!
  • The quality control / testing is not sufficient!
  • There are too many / too few releases!
  • It breaks too frequently!
  • This just isn't good enough!
  • My tone is disrespectful!

This is the joy of open source. A sense of entitlement regarding when/how soon fixes should be provided, or new features developed, is misunderstanding the fundamental dynamics of open source. I am sorry you feel this way, but open source software (including this card) is typically provided "as-is". Take it or leave it. If you want things to go faster / differently, please contribute. If you don't want to contribute to the shared codebase, fork it and make your own. Or pay for a (different) Enterprise grade solution to your problem. This is certainly not that -- a card, developed in hobbiest-level time, with hobbiest-level skills and ... at best ... hobbiest level support.

If you find yourself complaining, your expectations are incorrect! This is undoubtedly frustrating (and I have often shared in this frustration), but it is nonetheless just the way open source is. Take it or leave it.

Thank you for understanding!