I recently gave my second shot at trying to set up the Recalls feature of OpenDental and making it compatible with our scheduling protocols, and this time I made quite a bit of progress, and I'm almost there!
In the process, however, I ran into a few gotchas where the behavior wasn't quite what one would expect from following directions and reading documentation, which cost some time, and also triggered (pun intended) me to spend quite a bit of your support desk people's time too.
I'm posting this here because, although not development related, I have a few suggestions for minor additions to the documentation that would have saved me a lot of time if I'd read them before poking around OD... These aren't revolutionary discoveries, but hopefully they'll fill in some gray areas in understanding and will help some people in the future

1. One should never re-assign "special type" from one recall type to another without first wiping both recalls clean, otherwise you may end up with existing recalls changing special types.
...In my case, I ended up with lots of patients with a prophy and a perio special type which is very bad. Fortunately, one of the developers helped me quickly take the bullet out of my foot (Darek I believe - thanks!)
2. As a matter of fact, don't change recall types at all without wiping them clean first. Other unexpected bad things might happen.
3. When deciding which recall has an appointment scheduled already (for removal from the recall "list", and for "scheduled date" in the family module), Open Dental ONLY looks at the TRIGGERS, not the procedures for the new appointment. Therefore:
a) You can't have a case where you're trying to create an appt from a trigger that's NOT in the list of procs on the appointment (for example, the endo followup example in the documentation is not possible - i.e. Endo triggers ReEval). If you do this, it will always think the patient is due for that "recall", even after you've scheduled it.
b) An appointment with ANY procedure in the triggers list will look like the recall is scheduled. Therefore, if you happen to have your Prophy recall type configured similar to the documentation at http://opendental.com/manual/recalltypes.html like I do, and someone happens to schedule a comprehensive exam (D0150) for a patient, it will supress the prophy recall until 6 months after the D0150 is completed (probably not something you'd want).
4. Recall types without a "Special Type" are ONLY SECONDARY PROCEDURES THAT WILL BE ADDED TO A RECALL APPOINTMENT, and they will NOT trigger an appointment creation by themselves. Therefore, again, the "endo followup" example in the docs is impossible, because if you set up a recall type for that (say 2 weeks later), the followup check procedure will ONLY show up on the following prophy or perio recall appointment whenever that happens to be, and so there won't be an appointment 2 weeks later.
5. At http://opendental.com/manual/recalltypes.html it says "Every patient will be assigned a prophy recall regardless of any previous triggers. This is to keep patients from falling through the cracks". While true, the recall has no date associated with it, so if your "recall list" window is set up with a start date by default, it looks like this statement is not true. HOWEVER, thanks to a very helpful support person I spoke to today, you can "keep patients from falling through the cracks" simply by removing the start date

PS,
Kudos to anyone who recognizes the reference from the title of this post
