diff --git a/arch/README.txt b/arch/README.txt
index 3a717c46bc..b93474e81d 100644
--- a/arch/README.txt
+++ b/arch/README.txt
@@ -222,6 +222,17 @@ arch/arm - ARM-based micro-controllers
         but no testing has been performed due to some problems I am having with my
         JTAG wiggler and OpenOCD on Linux.
 
+arch/avr
+    This directory is dedicated to ports to the Atmel AVR (8-bit) and AVR32 (32-bit)
+    MCU families.  STATUS:  Under development.
+
+    arch/avr/include/avr32 and arch/avr/src/avr32
+      Common support for all AVR32 MCUs
+
+    arch/avr/include/at91uc3 and arch/avr/src/at91uc3
+      Support specifically for the AT91UC3Bxxx family (specifically only for
+      the AT91UC3B0256 at the moment).
+
 arch/hc
     This directory is dedicated to ports to the Freescale HC family.
 
diff --git a/configs/README.txt b/configs/README.txt
index 8f0e02ea21..725715e2b5 100644
--- a/configs/README.txt
+++ b/configs/README.txt
@@ -49,6 +49,7 @@ following characteristics:
 
 
 	<board-name>
+        |-- README.txt
 	|-- include/
 	|   `-- (board-specific header files)
 	|-- src/
@@ -66,6 +67,9 @@ following characteristics:
 Summary of Files
 ^^^^^^^^^^^^^^^^
 
+README.txt -- This text file provides additional information unique to
+  each board configuration sub-directory.
+
 include/ -- This directory contains board specific header files.  This
   directory will be linked as include/arch/board at configuration time and
   can be included via '#include <arch/board/header.h>'.  These header file
@@ -798,6 +802,13 @@ setenv.sh -- This is a script that you can include that will be installed at
 Supported Boards
 ^^^^^^^^^^^^^^^^
 
+configs/avr32dev1
+    This is a port of NuttX to the Atmel AVR32DEV1 board.  That board is
+    based on the Atmel AT91UC3B0256 MCU and uses a specially patched
+    version of the GNU toolchain:  The patches provide support for the
+    AVR32 family.  That patched GNU toolchain is available only from the
+    Atmel website.  STATUS: Under development.
+
 configs/c5471evm
     This is a port to the Spectrum Digital C5471 evaluation board.  The
     TMS320C5471 is a dual core processor from TI with an ARM7TDMI general