===========================
Updating from Archibald 2.x
===========================

Introduction
============

Archibald 3 has a very different architecture compared to Archibald 2. Archibald 2 did many things that were contrary to best practices in the Drupal community, and didn't allow sites to leverage the power of third-party modules to enhance it.

For example, Archibald 2.x had its own database abstraction layer, handled its content via custom code instead of using Entities, had its custom translation logic, etc. It required specific user roles, and was hard to uninstall.

This has all changed with Archibald 3. Compared to Archibald 2, Archibald 3 has far less code (about 30%), and heavily uses what the Drupal ecosystem provides. For example, Archibald 3 uses nodes for content, custom entities for the VCards and Partners, Views for content listing and administration UIs, etc. This makes it a lot more flexible, and allows site administrators to use other, third-party modules (or even write their own) to enhance their users' experience.

Furthermore, a lot of effort was put into redesigning the UI. Archibald 3 is easier to use, and greatly simplifies the publishing workflow. Archibald 3 also gets rid of the search engine, which was source of a lot of confusion and frustration for some partners. Partners are now encouraged to install the "dsb Portal" module instead, if they require a search functionality.

Finally, Archibald 3 introduces a wealth of unit-and-functional tests, making it a very stable branch.

Upgrade path
============

Because of the vast differences in content management (node and entities VS custom logic), there is currently no upgrade path, and none is planned. The way we recommend people to upgrade is to either:

A) Create a whole new Drupal instance and install Archibald (or use Archibald Kickstart directly). Create user accounts, set up roles, etc (Archibabld 3 doesn't require any special roles).
 or
B) Disable and uninstall Archibald 2, and install Archibald 3.

In both cases, once set up, enable the Archibald Import module, and import descriptions straight from the National Catalog. This will import published data, and convert it to LOM-CHv1.2 during the process (Archibald 2 publishes using the LOM-CHv1.1 format).

Check out README.txt on instructions for install Archibald 3.


