Leaner stylesheet, better TOC organization, misc doc corrections

Documentation/A-few-interesting-extensibility-points.markdown

@@ -0,0 +1 @@
+> This topic is a place holder and does not exist yet.

Documentation/Adding-Pages-to-Your-Site.markdown

@@ -1,16 +1,19 @@
 
-After you create a Web site in Orchard, you will need to add to pages for your content. This topic shows how to create a new web page, add content using Orchard's rich-text editor, and publish the page to your web site.
+After you create a Web site in Orchard, you will need to add to pages for your content.
+This topic shows how to create a new web page, add content using Orchard's rich-text editor,
+and publish the page to your web site.
 
 # Creating a New Page
 
-In the Admin Panel under **Content**, click **Create Page**. The **Create Page** settings are displayed, as shown in the following image.
+In the Admin Panel under **Content**, click **Create Page**.
+The **Create Page** settings are displayed, as shown in the following image.
 
 ![](../Upload/screenshots_675/Create_Page.png)
 
-Using the **Create Page** settings, you can do the following:
+Using the **New Page** menu entry, you can do the following:
 
 * Give your new page a title.
-* Add a permalink. 
+* Add a search-engine-friendly address for your page (permalink)
 * Set the new page as the home page for the web site.
 * Add content using the rich-text editor.
 * Add content tags. 
@@ -20,26 +23,47 @@ Using the **Create Page** settings, you can do the following:
 * Save and publish the page to the site.
 
 ## Permalinks
-A permalink is a URL that points to this page indefinitely and is less susceptible to "link rot" (links that become unavailable). A suggested permalink based on the page title is automatically provided when you enter the text box. You can accept the one provided or change it as needed.
+
+A permalink is a URL that points to this page indefinitely and is less susceptible to "link rot"
+(links that become unavailable).
+A suggested permalink based on the page title is automatically provided when you enter the text box.
+You can accept the one provided or change it as needed.
 
 ![](../Upload/screenshots/Permalink.png)
 
 ## Content Tags
-A content tag assigns a content category to this page. For example, a page about famous fiction authors might have the following tags: authors, fiction, and books. After the page is published, a list of tags assigned to the page is displayed below the body of the content. By clicking on  a tag, the user can find all of the pages on your web site that have the same tag assigned.
+
+A content tag assigns a content category to this page.
+For example, a page about famous fiction authors might have the following tags:
+authors, fiction, and books. After the page is published, a list of tags assigned
+to the page is displayed below the body of the content.
+By clicking on  a tag, the user can find all of the pages on your web site that have the same tag assigned.
 
 ## Show on Main Menu
-If you want a link to this page to appear on the main menu, select the **Show on main menu** check box. When this option is selected, the **Menu text** box will be displayed and you can enter the text to display on the main menu.
+
+If you want a link to this page to appear on the main menu, select the **Show on main menu** check box.
+When this option is selected, the **Menu text** box will be displayed and
+you can enter the text to display on the main menu.
 
 ![](../Upload/screenshots/ShowOnMainMenu.png)
 
 ## User Comments
-To enable users to post comments on the page, select the **Allow new comments** check box. A form will be added to the bottom of the page for user comments. The following image shows the form that is added to the published page.
+
+> Comments are not enabled by default on pages. To enable them, go to `Content -> Content Types`
+and edit the `Page` content type, then add the `Comments` part.
+
+To enable users to post comments on the page, select the **Allow new comments** check box.
+A form will be added to the bottom of the page for user comments.
+The following image shows the form that is added to the published page.
 
 ![](../Upload/screenshots/AddComment.png)
 
 # Using the Rich-text Editor
 
-The Orchard text editor enables you to add content to your web page while taking advantage of its powerful rich-text features. The following image shows the editor's tool bar with each button labeled. The label shown here is consistent with the tooltip that appears when you hover over the button.
+The Orchard text editor enables you to add content to your web page while
+taking advantage of its powerful rich-text features.
+The following image shows the editor's tool bar with each button labeled.
+The label shown here is consistent with the tooltip that appears when you hover over the button.
 
 ![](../Upload/screenshots/EditorControls.png)
 
@@ -53,6 +77,7 @@ Some of the less commonly available editing features include the following:
 
 # Saving and Publishing a Page
 
-The controls along the bottom of the page enable you to save a draft of your new page, publish the page to your web site immediately, or schedule the page to be published at a specified date and time.
+The controls along the bottom of the page enable you to save a draft of your new page,
+publish the page to your web site immediately, or schedule the page to be published at a specified date and time.
 
 ![](../Upload/screenshots/save_publish_buttons.png)

Documentation/Adding-a-Blog-to-Your-Site.markdown

@@ -1,9 +1,11 @@
 
-Orchard provides a powerful blogging engine that makes it easy to add a blog to your web site. This topic describes how to create a blog for your site and then add a new blog post.
+Orchard provides a blogging engine that makes it easy to add a blog to your web site.
+This topic describes how to create a blog for your site and then add a new blog post.
 
 # Creating a New Blog
 
-In the Admin Panel under **Blogs**, click **Create New Blog**. The **Create New Blog** settings are displayed, as shown in the following image.
+In the Admin Panel under **Blogs**, click **Create New Blog**.
+The **Create New Blog** settings are displayed, as shown in the following image.
 
 ![](../Upload/screenshots_675/blog_create_675.png)
 
@@ -17,13 +19,15 @@ Using the **Create New Blog** settings, you can do the following:
 * Indicate whether to show the blog on the main menu.
 * Assign an owner for the blog.
 
-For more information about permalinks, content tags, or the **Show on main menu** checkbox, see [Adding Pages to Your Site](Adding-Pages-to-Your-Site).
+For more information about permalinks, content tags, or the **Show on main menu** checkbox,
+see [Adding Pages to Your Site](Adding-Pages-to-Your-Site).
 
 After selecting the settings for your blog, click **Add** to add the new blog to your site.
 
 # Creating a New Blog Post
 
-As soon as the blog is added to your site, you can add blog posts. As the following image shows, click **New Post** to add a blog post.
+As soon as the blog is added to your site, you can add blog posts.
+As the following image shows, click **New Post** to add a blog post.
 
 ![](../Upload/screenshots_675/blog_new_post_675.png)
 
@@ -42,7 +46,8 @@ Using the **Create New Blog Post** settings, you can do the following:
 * Assign an owner for the blog post.
 * Save and publish the blog post to the site.
 
-For more information about using the text editor or saving and publishing the blog post, see [Adding Pages to Your Site](Adding-Pages-to-Your-Site).
+For more information about using the text editor or saving and publishing the blog post,
+see [Adding Pages to Your Site](Adding-Pages-to-Your-Site).
 
 After you have created a new blog and published it to your site, your blog will look similar to the following image.
 

Documentation/Adding-admin-menu-items.markdown

@@ -0,0 +1 @@
+> This topic is a place holder and does not exist yet.

Documentation/Adding-and-managing-media-content.markdown

@@ -1,5 +1,10 @@
-
-When you upload images using the rich-text editor in Orchard (or using an XML-RPC client, such as [Windows Live Writer](http://explore.live.com/windows-live-writer)), the images are saved in a _Media_ folder under the root of your Orchard installation. The _Media_ folder must be writable (by the user process that's running the website) in order for image uploads to succeed. If you installed Orchard using the [Web Platform Installer](http://www.microsoft.com/web/downloads/platform.aspx), the _Media_ folder write permissions are configured automatically.
+When you upload images using the rich-text editor in Orchard
+(or using an XML-RPC client, such as [Windows Live Writer](http://explore.live.com/windows-live-writer)),
+the images are saved in a _Media_ folder under the root of your Orchard installation.
+The _Media_ folder must be writable (by the user process that's running the website) in order
+for image uploads to succeed.
+If you installed Orchard using the [Web Platform Installer](http://www.microsoft.com/web/downloads/platform.aspx),
+the _Media_ folder write permissions are configured automatically.
 
 To add and delete media folders, click **Media** in the dashboard. 
 
@@ -9,12 +14,14 @@ Browse to a media image file and view the details. The properties of a media fil
 
 * **Screenshot**. A thumbnail preview of the image content.
 * **Size** and **Added on**. Properties of the media file.
-* **Embed**. The URL of the media file, which you can copy to the HTML view of the rich-text editor in order to embed the media image into content.
+* **Embed**. The URL of the media file, which you can copy to the HTML view of the rich-text editor
+in order to embed the media image into content.
 * **Name**. The name of the media file.
 
 ![](../Upload/screenshots/edit_media_1.png)
 
-To manage the subfolders for your media folder, click **Media** again on the dashboard. Then click a folder to display the **Manage Folder** screen. 
+To manage the subfolders for your media folder, click **Media** again on the dashboard.
+Then click a folder to display the **Manage Folder** screen. 
 
 ![](../Upload/screenshots_675/manage_media_folders_675.png)
 
@@ -30,9 +37,13 @@ Browse to the new subfolder and click **Add media**.
 
 ![](../Upload/screenshots_675/add_media_1_675.png)
 
-Orchard lets you upload single media files as well as uploading a _.zip_ file that contains multiple image files. If you have a large set of images to upload, it can be more efficient to first add them all to a _.zip_ file and then just upload the _.zip_ file instead of uploading the images one by one. 
+Orchard lets you upload single media files as well as uploading a _.zip_ file that contains multiple image files.
+If you have a large set of images to upload, it can be more efficient to first add them all to a _.zip_ file
+and then just upload the _.zip_ file instead of uploading the images one by one. 
 
-To see how this works, create a _.zip_ file on your computer that contains several image files, and then click **Upload**. The **Extract zip** checkbox is selected by default, which will cause the uploaded images in the _.zip_ to be extracted and added to the folder.
+To see how this works, create a _.zip_ file on your computer that contains several image files,
+and then click **Upload**. The **Extract zip** checkbox is selected by default,
+which will cause the uploaded images in the _.zip_ to be extracted and added to the folder.
 
 ![](../Upload/screenshots_675/upload_zip_media_675.png)
 
@@ -44,9 +55,6 @@ To see or edit the details of an individual uploaded image, click it.
 
 ![](../Upload/screenshots_675/upload_zip_media_3_675.png)
 
-
-
-
 ### Change History
 * Updates for Orchard 1.1
     * 3-16-11: Updated all screen shots and menu choices text.

Documentation/Adding-code-to-themes.markdown

@@ -0,0 +1 @@
+> This topic is a place holder and does not exist yet.

Documentation/Adding-custom-admin-pages.markdown

@@ -0,0 +1 @@
+> This topic is a place holder and does not exist yet.