summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/admin.md2
-rw-r--r--doc/future.md26
-rw-r--r--doc/setup.md67
3 files changed, 95 insertions, 0 deletions
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