add instructions for transition from official to our repositories

1 files changed, 13 insertions, 0 deletions

diff --git a/download/index.html b/download/index.html
index 979c699..9c959cf 100644
--- a/download/index.html
+++ b/download/index.html
@@ -54,6 +54,19 @@
     to update your existing system. You may be looking for
     <a href="https://raw.githubusercontent.com/archlinux32/packages/master/core/pacman-mirrorlist/mirrorlist">an updated mirrorlist</a> instead.</p>
 
+    <h3>Transition from the Official Repositories</h3>
+
+    <p>If you plan to move from the <a href="https://www.archlinux.org/packages/">official repositories</a>
+    to <a href="https://mirror.archlinux32.org/i686/">our community maintained repositories</a>, follow
+    these steps:
+    <ul>
+        <li> Put any mirror from <a href="https://raw.githubusercontent.com/archlinux32/packages/master/core/pacman-mirrorlist/mirrorlist">our mirrolist</a>
+             into <code>/etc/pacman.d/mirrorlist</code>.
+        <li> Execute <code>pacman -Syyw archlinux32-keyring</code> to download our keyring package.
+        <li> Execute <code>pacman -U /var/cache/pacman/pkg/archlinux32-keyring-*.pkg.tar.xz</code> to install our keyring package.
+        <li> Run <code>pacman -Suu</code> for a full transition. Note, that some packages are currently newer in the official repositories and will be downgraded, therefore.
+    </ul></p>
+
     <h3>HTTP Direct Downloads</h3>
 
     <p>Install images can be downloaded via HTTP from the mirror sites. Please