[bop-devel] why do the payment implementations all load Exporter?

[Ivan Kohler]

On Thu, Dec 07, 2006 at 02:20:54AM -0800, Jo Rhett wrote:
> Ivan Kohler wrote:
> >>1. Is there a documentation home for this project?  I'm spending a lot 
> >>of time reading the source code to determine basic things, like "do the 
> >>modules deal with expiration dates in X format..."
> 
>  > I was at first thinking perhaps a Wiki, but on the other hand, I 
> tend to
> >look at modules on search.cpan.org rather than go to home pages, so 
> >perhaps we should try and maintain the documentation as POD in the 
> >source instead...
> 
> I like the Wiki idea.  And when a new release is cut someone could take 
> what they like from the Wiki to include in the POD.   And/or include a 
> link in the POD to the Wiki.

We can use space in the Wiki at http://www.sisd.com/mediawiki, if 
you guys don't mind the Freeside branding (don't 
know offhand how I'd go about setting up multiple instances).  Say, 
http://www.sisd.com/mediawiki/index.php/Business::OnlinePayment

Or if someone else wants to setup an exclusive Wiki for B:OP, I'm fine 
with that too.

> > If you could start at least taking down some notes on the things that
> > you would have liked to have documentation for, that would be great.
> 
> Frankly, all the obvious questions.  What data formats are supported for 
> each and every method?  I'm one of those annoying programmers that 
> thinks that you shouldn't have to read the code to use a library :-)
> (I almost always end up doing so, but it annoys me)

I don't think this is particularly well defined/constrained, other than 
the obvious (card numbers have to be card numbers, etc.), so it isn't 
surprising there isn't documentation.

Obvious doesn't mean making a list isn't useful.  Makes it easier for 
folks to start filling in the details.  :)

-- 
_ivan