1.
I don't want for the configuration file to be kept within the "okapi"
directory. This could complicate updates (currently okapi can be
updated by just deleting it, and loading a new copy). Also, from what
I know, all OC settings are kept in the lib/settings.inc.php - OKAPI
will try to read it from there.
2.
You proposed two options: caches_stat_option and caches_have_votes.
Oc.pl uses caches_stat_option=1 and caches_have_votes=1.
Oc.de uses caches_stat_option=2 and caches_have_votes=0.
But I think there are no installations which will use any OTHER
combinations of these two flags. Am I correct? Do you think there will
EVER be such installations?
If not, I would still prefer to have it simpler:
if (oc.de) { sql(..) } else { sql(..) }.
I know having tons of settings seems professional, but I'd like to
keep things simple. SQL queries dependant on such multiple flags are
not simple at all.
As I understand, there are only two major OC ports - yours and ours.
Every other OC is based on oc.pl OR oc.de. That's why, the "if
(oc.de)" solution seems the right one here.
Having other settings would create an illusion, that other OC nodes
could use some of oc.pl code, and some of the oc.de code. But I think,
this *IS* an illusion. I think no one - except possibly us - will ever
try to merge any parts of oc.pl and oc.de.
I used the "if (oc.de)" approach (at least for now). This will
simplify any changes you will have to make to get it working on oc.de.
3.
Added some docs.
See here:
http://code.google.com/p/opencaching-api/source/browse/trunk/okapi/settings.phpand here:
http://code.google.com/p/opencaching-api/source/detail?r=81