Index: wp-content/themes/twentyten/searchform.php
===================================================================
--- wp-content/themes/twentyten/searchform.php	(revision 13897)
+++ wp-content/themes/twentyten/searchform.php	(working copy)
@@ -6,8 +6,9 @@
  * when the get_search_form() template tag is used.
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/footer.php
===================================================================
--- wp-content/themes/twentyten/footer.php	(revision 13897)
+++ wp-content/themes/twentyten/footer.php	(working copy)
@@ -6,8 +6,9 @@
  * after.  Calls sidebar-footer.php for bottom widgets
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
@@ -15,7 +16,7 @@
 
 	<div id="footer">
 		<div id="colophon">
-
+<?php /* Add our footer widget areas */  ?>
 <?php get_sidebar( 'footer' ); ?>
 
 			<div id="site-info">
@@ -30,7 +31,7 @@
 	</div><!-- #footer -->
 
 </div><!-- #wrapper -->
-
+<?php /* Always have wp_footer() just before the closing </body> tag of your theme if you want many plugins to work */  ?>
 <?php wp_footer(); ?>
 
 </body>
Index: wp-content/themes/twentyten/author.php
===================================================================
--- wp-content/themes/twentyten/author.php	(revision 13897)
+++ wp-content/themes/twentyten/author.php	(working copy)
@@ -3,8 +3,9 @@
  * The template used to display Author Archive pages
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/sidebar-footer.php
===================================================================
--- wp-content/themes/twentyten/sidebar-footer.php	(revision 13897)
+++ wp-content/themes/twentyten/sidebar-footer.php	(working copy)
@@ -3,8 +3,9 @@
  * The Footer widget areas
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/search.php
===================================================================
--- wp-content/themes/twentyten/search.php	(revision 13897)
+++ wp-content/themes/twentyten/search.php	(working copy)
@@ -3,8 +3,9 @@
  * The Search Results template
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/404.php
===================================================================
--- wp-content/themes/twentyten/404.php	(revision 13897)
+++ wp-content/themes/twentyten/404.php	(working copy)
@@ -3,8 +3,9 @@
  * The template for displaying 404 pages (Not Found)
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/index.php
===================================================================
--- wp-content/themes/twentyten/index.php	(revision 13897)
+++ wp-content/themes/twentyten/index.php	(working copy)
@@ -5,17 +5,18 @@
  *
  * This is the most generic template file in a WordPress theme
  * and one of the two required files for a theme (the other being style.css).
- * It is used to display a page when nothing more specific matches a query. 
+ * It is used to display a page when nothing more specific matches a query.
  * E.g., it puts together the home page when no home.php file exists.
  * Learn more: http://codex.wordpress.org/Template_Hierarchy
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
- 
+
 ?>
- 
+
 <?php get_header(); ?>
 
 		<div id="container">
Index: wp-content/themes/twentyten/functions.php
===================================================================
--- wp-content/themes/twentyten/functions.php	(revision 13897)
+++ wp-content/themes/twentyten/functions.php	(working copy)
@@ -37,8 +37,9 @@
  * For more information on hooks, see http://codex.wordpress.org/Plugin_API.
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 
 /**
@@ -71,7 +72,8 @@
  * @uses register_default_headers() To register the default custom header images provided with the theme.
  * @uses set_post_thumbnail_size() To set a custom post thumbnail size.
  *
- * @since 3.0.0
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 function twentyten_setup() {
 
@@ -110,7 +112,7 @@
 	define( 'HEADER_IMAGE_HEIGHT', apply_filters( 'twentyten_header_image_height',	198 ) );
 
 	// We'll be using post thumbnails for custom header images on posts and pages.
-	// We want them to be 940 pixels wide by 198 pixels tall (larger images will be auto-cropped to fit).
+	// We want them to be 940 pixels wide by 198 pixels tall (larger images will be auto-cropped to fit, smaller ones will be ignored  See header.php).
 	set_post_thumbnail_size( HEADER_IMAGE_WIDTH, HEADER_IMAGE_HEIGHT, true );
 
 	// Don't support text inside the header image.
@@ -173,7 +175,8 @@
  *
  * Referenced via add_custom_image_header() in twentyten_setup().
  *
- * @since 3.0.0
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 function twentyten_admin_header_style() {
 ?>
@@ -196,7 +199,8 @@
  *
  * Used in Twenty Ten's header.php to add the page number to the <title> HTML tag.
  *
- * @since 3.0.0
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 function twentyten_the_page_number() {
 	global $paged; // Contains page number.
@@ -211,6 +215,9 @@
  * To override this length in a child theme, remove the filter and add your own
  * function tied to the excerpt_length filter hook.
  *
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
+ *
  * @return int
  */
 function twentyten_excerpt_length( $length ) {
@@ -224,7 +231,8 @@
  * To override this link in a child theme, remove the filter and add your own
  * function tied to the excerpt_more filter hook.
  *
- * @since 3.0.0
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  * @return string A pretty 'Continue reading' link.
  */
 function twentyten_excerpt_more( $more ) {
@@ -237,6 +245,9 @@
  *
  * Galleries are styled by the theme in Twenty Ten's style.css.
  *
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
+ *
  * @return string The gallery style filter, with the styles themselves removed.
  */
 function twentyten_remove_gallery_css( $css ) {
@@ -253,7 +264,8 @@
  *
  * Used as a callback by wp_list_comments() for displaying the comments.
  *
- * @since 3.0.0
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 function twentyten_comment( $comment, $args, $depth ) {
 	$GLOBALS ['comment'] = $comment; ?>
@@ -294,6 +306,9 @@
  *
  * @uses twentyten_term_list
  *
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
+ *
  * @return string
  */
 function twentyten_cat_list() {
@@ -308,6 +323,9 @@
  * Returns the list of tags based on if we are or are not
  * browsing a tag archive page
  *
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
+ *
  * @uses twentyten_term_list
  *
  * @return string
@@ -327,6 +345,9 @@
  * type of page.  If browsing a term archive page and the
  * post has no other taxonomied terms, it returns empty
  *
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
+ *
  * @return string
  */
 function twentyten_term_list( $taxonomy, $glue = ', ', $text = '', $also_text = '' ) {
@@ -361,10 +382,14 @@
  *
  * To override twentyten_widgets_init() in a child theme, remove the action hook and add your own
  * function tied to the init hook.
+ *
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
+ *
  * @uses register_sidebar
  */
 function twentyten_widgets_init() {
-	// Area 1
+	// Area 1 located at the top of the sidebar
 	register_sidebar( array (
 		'name' => 'Primary Widget Area',
 		'id' => 'primary-widget-area',
@@ -375,7 +400,7 @@
 		'after_title' => '</h3>',
 	) );
 
-	// Area 2
+	// Area 2 located below the Primary Widget Area in the sidebar.  Empty by default and design
 	register_sidebar( array (
 		'name' => 'Secondary Widget Area',
 		'id' => 'secondary-widget-area',
@@ -386,7 +411,7 @@
 		'after_title' => '</h3>',
 	) );
 
-	// Area 3
+	// Area 3 located in the footer.  Empty by default
 	register_sidebar( array (
 		'name' => 'First Footer Widget Area',
 		'id' => 'first-footer-widget-area',
@@ -397,7 +422,7 @@
 		'after_title' => '</h3>',
 	) );
 
-	// Area 4
+	// Area 4 located in the footer.  Empty by default
 	register_sidebar( array (
 		'name' => 'Second Footer Widget Area',
 		'id' => 'second-footer-widget-area',
@@ -408,7 +433,7 @@
 		'after_title' => '</h3>',
 	) );
 
-	// Area 5
+	// Area 5 located in the footer.  Empty by default
 	register_sidebar( array (
 		'name' => 'Third Footer Widget Area',
 		'id' => 'third-footer-widget-area',
@@ -419,7 +444,7 @@
 		'after_title' => '</h3>',
 	) );
 
-	// Area 6
+	// Area 6 located in the footer.  Empty by default
 	register_sidebar( array (
 		'name' => 'Fourth Footer Widget Area',
 		'id' => 'fourth-footer-widget-area',
Index: wp-content/themes/twentyten/loop.php
===================================================================
--- wp-content/themes/twentyten/loop.php	(revision 13897)
+++ wp-content/themes/twentyten/loop.php	(working copy)
@@ -8,8 +8,9 @@
  * the tags used in it.
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/onecolumn-page.php
===================================================================
--- wp-content/themes/twentyten/onecolumn-page.php	(revision 13897)
+++ wp-content/themes/twentyten/onecolumn-page.php	(working copy)
@@ -6,8 +6,9 @@
  * Selectable from a dropdown menu on the edit page screen.
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/sidebar.php
===================================================================
--- wp-content/themes/twentyten/sidebar.php	(revision 13897)
+++ wp-content/themes/twentyten/sidebar.php	(working copy)
@@ -3,8 +3,9 @@
  * The Sidebar containing the primary and secondary widget areas
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/tag.php
===================================================================
--- wp-content/themes/twentyten/tag.php	(revision 13897)
+++ wp-content/themes/twentyten/tag.php	(working copy)
@@ -3,8 +3,9 @@
  * The template used to display Tag Archive pages
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
@@ -18,7 +19,7 @@
 				<h1 class="page-title"><?php
 					printf( __( 'Tag Archives: %s', 'twentyten' ), '<span>' . single_tag_title( '', false ) . '</span>' );
 				?></h1>
-
+<?php /* Since we used the_post and single_tag_title to set our page title, we need to rewind_post to reset the loop counter and properly loop through them.   */ ?>
 <?php rewind_posts(); ?>
 
 <?php
Index: wp-content/themes/twentyten/page.php
===================================================================
--- wp-content/themes/twentyten/page.php	(revision 13897)
+++ wp-content/themes/twentyten/page.php	(working copy)
@@ -8,8 +8,9 @@
  * different template.
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
@@ -23,9 +24,9 @@
 				<div id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
 					<?php if ( is_front_page() ) { ?>
 						<h2 class="entry-title"><?php the_title(); ?></h2>
-					<?php } else { ?>	
+					<?php } else { ?>
 						<h1 class="entry-title"><?php the_title(); ?></h1>
-					<?php } ?>				
+					<?php } ?>
 
 					<div class="entry-content">
 						<?php the_content(); ?>
Index: wp-content/themes/twentyten/category.php
===================================================================
--- wp-content/themes/twentyten/category.php	(revision 13897)
+++ wp-content/themes/twentyten/category.php	(working copy)
@@ -3,8 +3,9 @@
  * The template used to display Category Archive pages
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
@@ -16,6 +17,8 @@
 				<h1 class="page-title"><?php
 					printf( __( 'Category Archives: %s', 'twentyten' ), '<span>' . single_cat_title( '', false ) . '</span>' );
 				?></h1>
+
+				<?php /* If a category description is set for this catagory, we display it.  If you want to remove it, you can apply a filter to archive_meta that returns an empty string */ ?>
 				<?php $categorydesc = category_description(); if ( ! empty( $categorydesc ) ) echo apply_filters( 'archive_meta', '<div class="archive-meta">' . $categorydesc . '</div>' ); ?>
 
 				<?php
Index: wp-content/themes/twentyten/archive.php
===================================================================
--- wp-content/themes/twentyten/archive.php	(revision 13897)
+++ wp-content/themes/twentyten/archive.php	(working copy)
@@ -8,8 +8,9 @@
  * Learn more: http://codex.wordpress.org/Template_Hierarchy
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/single.php
===================================================================
--- wp-content/themes/twentyten/single.php	(revision 13897)
+++ wp-content/themes/twentyten/single.php	(working copy)
@@ -3,8 +3,9 @@
  * The Template used to display all single posts
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/comments.php
===================================================================
--- wp-content/themes/twentyten/comments.php	(revision 13897)
+++ wp-content/themes/twentyten/comments.php	(working copy)
@@ -8,8 +8,9 @@
  * located in the functions.php file
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
Index: wp-content/themes/twentyten/header.php
===================================================================
--- wp-content/themes/twentyten/header.php	(revision 13897)
+++ wp-content/themes/twentyten/header.php	(working copy)
@@ -5,8 +5,9 @@
  * Displays all of the <head> section and everything up till <div id="main">
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>
 
@@ -16,25 +17,27 @@
 	<meta charset="<?php bloginfo( 'charset' ); ?>" />
 	<title><?php
 	// Returns the title based on the type of page being viewed
-		if ( is_single() ) {
+		if ( is_single() ) { // Single post pages
 			single_post_title(); echo ' | '; bloginfo( 'name' );
-		} elseif ( is_home() || is_front_page() ) {
+		} elseif ( is_home() || is_front_page() ) { // Both the home page and if using a static front page, the blog post page
 			bloginfo( 'name' ); echo ' | '; bloginfo( 'description' ); twentyten_the_page_number();
-		} elseif ( is_page() ) {
+		} elseif ( is_page() ) { // All Pages
 			single_post_title( '' ); echo ' | '; bloginfo( 'name' );
-		} elseif ( is_search() ) {
+		} elseif ( is_search() ) { // Search result pages
 			printf( __( 'Search results for "%s"', 'twentyten' ), esc_html( $s ) ); twentyten_the_page_number(); echo ' | '; bloginfo( 'name' );
-		} elseif ( is_404() ) {
+		} elseif ( is_404() ) { // 404, nothing found pages
 			_e( 'Not Found', 'twentyten' ); echo ' | '; bloginfo( 'name' );
-		} else {
+		} else { // Everything else
 			wp_title( '' ); echo ' | '; bloginfo( 'name' ); twentyten_the_page_number();
 		}
 	?></title>
 	<link rel="profile" href="http://gmpg.org/xfn/11" />
 	<link rel="stylesheet" type="text/css" media="all" href="<?php bloginfo( 'stylesheet_url' ); ?>" />
-	<?php if ( is_singular() ) wp_enqueue_script( 'comment-reply' ); ?>
+	<?php if ( is_singular() ) wp_enqueue_script( 'comment-reply' );  //On pages that have comment forms, we add some javascript to make threaded comments work ?>
 	<link rel="pingback" href="<?php bloginfo( 'pingback_url' ); ?>" />
+	<?php /* Always have wp_head() in the </head> of your theme if you want many plugins to work */  ?>
 	<?php wp_head(); ?>
+
 </head>
 
 <body <?php body_class(); ?>>
@@ -44,19 +47,19 @@
 			<div id="branding">
 				<?php if ( is_home() || is_front_page() ) { ?>
 					<h1 id="site-title"><span><a href="<?php echo home_url( '/' ); ?>" title="<?php echo esc_attr( get_bloginfo( 'name', 'display' ) ); ?>" rel="home"><?php bloginfo( 'name' ); ?></a></span></h1>
-				<?php } else { ?>	
+				<?php } else { ?>
 					<div id="site-title"><span><a href="<?php echo home_url( '/' ); ?>" title="<?php echo esc_attr( get_bloginfo( 'name', 'display' ) ); ?>" rel="home"><?php bloginfo( 'name' ); ?></a></span></div>
 				<?php } ?>
-				
+
 				<div id="site-description"><?php bloginfo( 'description' ); ?></div>
 
 				<?php
 					// Retrieve the dimensions of the current post thumbnail -- no teensy header images for us!
 					$image = wp_get_attachment_image_src( get_post_thumbnail_id( $post->ID ), 'post-thumbnail');
 					list($src, $width, $height) = $image;
-					
+
 					// Check if this is a post or page, if it has a thumbnail, and if it's a big one
-					if ( is_singular() && has_post_thumbnail( $post->ID ) && $width >= HEADER_IMAGE_WIDTH ) :		
+					if ( is_singular() && has_post_thumbnail( $post->ID ) && $width >= HEADER_IMAGE_WIDTH ) :
 						// Houston, we have a new header image!
 						echo get_the_post_thumbnail( $post->ID, 'post-thumbnail' );
 					else : ?>
@@ -65,7 +68,9 @@
 			</div><!-- #branding -->
 
 			<div id="access">
+			<?php /*  Allow screen readers / text browsers to skip the navigation menu and get right to the good stuff */ ?>
 				<div class="skip-link screen-reader-text"><a href="#content" title="<?php esc_attr_e( 'Skip to content', 'twentyten' ); ?>"><?php _e( 'Skip to content', 'twentyten' ); ?></a></div>
+				<?php /* Our navigation menu.  If one isn't filled out, wp_nav_menu falls back to wp_page_menu  */ ?>
 				<?php wp_nav_menu( array( 'sort_column' => 'menu_order', 'container_class' => 'menu-header' ) ); ?>
 			</div><!-- #access -->
 		</div><!-- #masthead -->
Index: wp-content/themes/twentyten/attachment.php
===================================================================
--- wp-content/themes/twentyten/attachment.php	(revision 13897)
+++ wp-content/themes/twentyten/attachment.php	(working copy)
@@ -3,8 +3,9 @@
  * The template used to display attachments.
  *
  * @package WordPress
- * @subpackage Twenty Ten
- * @since 3.0.0
+ * @subpackage Twenty_Ten
+ * @since WordPress 3.0.0
+ * @since Twenty_Ten 1.0.0
  */
 ?>