From a9656842108b1cce75efdd1ee9fe85f7138f99bc Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Mon, 9 Mar 2015 01:20:51 +0100
Subject: Rename (yet unused) topic address/addressbooks → contact.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/admin.md  |  2 ++
 doc/future.md | 26 +++++++++++++++++++++++
 doc/setup.md  | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 95 insertions(+)
 create mode 100644 doc/admin.md
 create mode 100644 doc/future.md
 create mode 100644 doc/setup.md

diff --git a/doc/admin.md b/doc/admin.md
new file mode 100644
index 0000000..49eecca
--- /dev/null
+++ b/doc/admin.md
@@ -0,0 +1,2 @@
+# Directory services maintainance commands
+
diff --git a/doc/future.md b/doc/future.md
new file mode 100644
index 0000000..1c32879
--- /dev/null
+++ b/doc/future.md
@@ -0,0 +1,26 @@
+# Timeline of (planned and effectuated) events relate to central address handling
+
+## TODO
+
+ * Public addressbook lookup through raw LDAP interface
+ * User-friendly access to public addressbook
+  * Integration with HORDE webmail framework
+  * Integration with Mozilla Thunderbird (documentation and possibly semi-automation)
+  * Web lookup page
+  * Wap lookup page
+  * SMS lookup routine
+ * Shared addressbooks for closed groups
+ * User-friendly access to shared addressbooks
+  * Integration with HORDE webmail framework
+  * Integration with Mozilla Thunderbird (documentation and possibly semi-automation)
+  * Web lookup page
+  * Wap lookup page
+  * SMS lookup routine
+ * Personal addressbooks (both discrete and public accessible)
+ * Semi-automated import (batch-adding) entries
+ * User-friendly access to adding and editing entries
+  * Integration with HORDE webmail framework
+  * Desktop apps (integration with system tools, use of generic tools, or design of custom tools)
+  * Web administration tool
+  * SMS add/overwrite routine
+ * Two-way syncronization with other personal (and shared?) directory databases
diff --git a/doc/setup.md b/doc/setup.md
new file mode 100644
index 0000000..86242a2
--- /dev/null
+++ b/doc/setup.md
@@ -0,0 +1,67 @@
+# Setting up and using central addresses
+
+## Looking up addresses
+
+### Web access
+
+ * Public search page
+
+ * Horde webmail
+
+### Desktop applications
+
+ * Mozilla Thunderbird
+
+### Cell phone
+
+ * SMS lookup
+
+## Adding and editing
+
+### Web access
+
+ * Horde webmail
+
+### Desktop applications
+
+ * Directory assistant (Linux, MacOS w/ X11)
+
+## Exchanging data
+
+### Importing addresses
+
+#### Well-structured address databases
+
+Some address book applications can export entries as an LDIF file.
+This often means the data is well-structured and easy to feed into the central database.
+
+Import of LDIF files is supported from the following applications:
+
+ * Mozilla Thunderbird
+
+If you use a different application and it can export LDIF files, then try if it works.
+Tell us your experiences, so we can (maybe improve the import routines and) add it to this list.
+
+#### Other sources
+
+For applications that cannot export LDIF, first feed the data into an application that does,
+and then import from there.
+
+Here's a possible recipe for a list of addresses stored in an Excel spreadsheet:
+
+ 1. Remove noise (eg. non-tabular comments)
+ 2. Export as comma-separated file
+   * Use "Western european (ISO-8859-1)" as character codepage (not Unicode)
+ 3. Open Mozilla Thunderbird, and select "Import..." from the Tools menu
+ 4. Import addressbook, choose "Comma Separated" and open the exported data file
+ 5. Match Address Book fields with records to import
+   * Use "Display Name" as full name, if first and last name was not previously stored separately
+   * Use company fields for company info, if each previous record contained both company and contact person info
+   * Use custom fields for custom data (avoid reusing standard fields for new purposes!)
+ 6. Review the imported data now stored in a new Address Book
+   * Re-import if not satisfied: The field matching is remembered from last import
+ 7. Edit entries as needed
+   * Each personal entry *must* contain both first name and last name
+   * Each company-only entry must contain *no* personal data
+
+### Two-way syncronization
-- 
cgit v1.2.3