[OPEN-ILS-DOCUMENTATION] zip code - zips.txt - pre-populate - Documentation

[Josh Stompro]

Thanks for all the tips and info everyone.  Please take a look at what I’ve come up with for documenting the zip code pre-fill feature and let me know what you think.    https://gist.github.com/stompro/5d6bea620f7cc01b8443

I didn’t add info about using the google API to brute force gather the data, it seems like an overly complex  solution compared with the others.  I also didn’t add info about using geocoder.ca to gather Canadian postal codes since the site doesn’t load for me.

I would also like to propose that the comments in zips.pm be updated to reflect the fact that the areacode is not used by register.js, maybe it was in the past, but not right now.
Josh

From: open-ils-documentation-bounces at list.georgialibraries.org [mailto:open-ils-documentation-bounces at list.georgialibraries.org] On Behalf Of Mike Rylander
Sent: Wednesday, September 03, 2014 10:40 AM
To: Documentation discussion for Evergreen software
Subject: Re: [OPEN-ILS-DOCUMENTATION] zip code - zips.txt - pre-populate - Documentation

I got curious just how far back ZIP lookup goes, and it starts with commit 2ea132cef5bf36106378f8c15943d0acbe443361 from 2006-05-03 ... It's been a thing since since before PINES went live!  Anyone up for retrospectively writing version 0.01 docs?


On Wed, Sep 3, 2014 at 11:18 AM, Kathy Lussier <klussier at masslnc.org<mailto:klussier at masslnc.org>> wrote:
Hi Josh,

I think a good rule of thumb is to only backport documentation as far back as we support releases. Currently, the community only supports the 2.5 and 2.6 releases, so I would only backport to 2.5 if the feature was available at that time. The release notes is probably the best place to look to see if it was something newly added to Evergreen.

I know that zip.txt features goes way back, so it should be no problem backporting to 2.5. When you send out a message saying that the documentation is available, maybe you can mention how far it should be backported. It looks like you can find that blog post in the Internet archive:

https://web.archive.org/web/20110417152404/http://dmagick.wordpress.com/2011/01/06/notes-on-installing-zipcode-information/<https://web.archive.org/web/20110417152404/http:/dmagick.wordpress.com/2011/01/06/notes-on-installing-zipcode-information/>

Thanks for all of your work filling in some of our doc gaps!

Kathy

Kathy Lussier
Project Coordinator
Massachusetts Library Network Cooperative
(508) 343-0128<tel:%28508%29%20343-0128>
klussier at masslnc.org<mailto:klussier at masslnc.org>
Twitter: http://www.twitter.com/kmlussier
#evergreen IRC: kmlussier


On 9/3/2014 11:10 AM, Josh Stompro wrote:
Hello, does anyone know where some current documentation on the zips.txt - zip code pre-populate feature is at?  I found a thread on the devel list from 2011 [1] that mentions this site, http://dmagick.wordpress.com/2011/01/06/notes-on-installing-zipcode-information/
But I think that domain expired and was picked up by someone else, there is no trace of that article on the site anymore.

I think I can figure most of it out by looking at the Zips.pm and from some comments I can find in IRC archives.

If I wanted to document this feature for the official documentation - would it go in the "System Configuration and Customization" section?

What would the official name of this feature be?  "Zip Code Pre-Populate"  "Zip Code Auto-Populate"  "Patron Address pre-populate based on Zip Code"

And a general question - should each feature section state when the feature was introduced, to make it easier to backport the documentation for previous versions.  Are new documentation additions added to the older documentation versions?

Thanks
Josh

1 - http://comments.gmane.org/gmane.education.libraries.open-ils.devel/5685

_______________________________________________
OPEN-ILS-DOCUMENTATION mailing list
OPEN-ILS-DOCUMENTATION at list.georgialibraries.org<mailto:OPEN-ILS-DOCUMENTATION at list.georgialibraries.org>
http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation

_______________________________________________
OPEN-ILS-DOCUMENTATION mailing list
OPEN-ILS-DOCUMENTATION at list.georgialibraries.org<mailto:OPEN-ILS-DOCUMENTATION at list.georgialibraries.org>
http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation



--
Mike Rylander
 | Director of Research and Development
 | Equinox Software, Inc. / Your Library's Guide to Open Source
 | phone:  1-877-OPEN-ILS (673-6457)
 | email:  miker at esilibrary.com<mailto:miker at esilibrary.com>
 | web:  http://www.esilibrary.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://list.georgialibraries.org/pipermail/open-ils-documentation/attachments/20140906/ab30c86c/attachment-0001.htm>