Merge pull request #164 from chrxr/master

Added editors guide docs

docs/editor_manual/documents_images_snippets/documents.rst

@@ -0,0 +1,17 @@
+Documents
+~~~~~~~~~
+
+Documents such as PDFs can be managed from the Documents interface, available in the left-hand menu. This interface allows you to add documents to and remove documents from the CMS.
+
+.. image:: ../../images/screen29_documents_page.png
+
+* Add documents by clicking the *Add document* button in the top-right.
+* Search for documents in the CMS by entering your search term in the search bar. The results will be automatically updated as you type.
+* You can also filter the results by *Popular tags*. Click on a tag to update the search results listing.
+* Edit the details of a document by clicking the document title.
+
+.. image:: ../../images/screen30_documents_edit_page.png
+
+* When editing a document you can replace the file associated with that document record. This means you can update documents without having to update the pages on which they are placed. Changing the file will change it on all pages that use the document.
+* Add or remove tags using the Tags field.
+* Save or delete documents using the buttons at the bottom of the interface. **NOTE:** deleted documents cannot be recovered.

docs/editor_manual/documents_images_snippets/images.rst

@@ -0,0 +1,13 @@
+Images
+~~~~~~
+
+If you want to edit, add or remove images from the CMS outside of the individual pages you can do so from the Images interface. This is accessed from the left-hand menu.
+
+.. image:: ../../images/screen31_images_page.png
+
+* Clicking an image will allow you to edit the data associated with it. This includes the Alt text, the photographers credit, the medium of the subject matter and much more. **NOTE:** changing the alt text here will alter it for all occurrences of the image in carousels, but not in inline images, where the alt text can be set separately.
+
+.. image:: ../../images/screen32_image_edit_page.png
+
+* When editing an image you can replace the file associated with that image record. This means you can update images without having to update the pages on which they are placed. Changing the file will change it on all pages that use the image.
+

docs/editor_manual/documents_images_snippets/index.rst

@@ -0,0 +1,12 @@
+Managing documents and images
+=============================
+
+Wagtail allows you to manage all of your documents and images through their own dedicated interfaces. See below for information on each of these elements.
+
+.. NEED TO ADD IN DETAILS ABOUT SNIPPETS HERE
+
+.. toctree::
+   :maxdepth: 3
+
+   documents
+   images

docs/editor_manual/documents_images_snippets/snippets.rst

@@ -0,0 +1,8 @@
+Snippets
+~~~~~~~~
+
+.. UNSURE HOW TO WRITE THIS AS THE ADVERT EXAMPLE IN WAGTAIL DEMO IS NOT A PARTICULARLY HELPFUL USE CASE. 
+
+When creating a page on a website, it is a common occurance to want to add in a piece of content that already exists on another page. An example of this would be a person's contact details, or an advert that you want to simply show on every page of your site, without having to manually apply it.
+
+Wagtail makes this easy with Snippets. 

docs/editor_manual/editing_existing_pages.rst

@@ -0,0 +1,14 @@
+Editing existing pages
+~~~~~~~~~~~~~~~~~~~~~~
+
+There are two ways that you can access the edit screen of an existing page:
+
+* Clicking the title of the page in an `Explorer page <the_explorer_page.html>`_ or in `search results <using_search.html>`_.
+* Clicking the *Edit* link below the title in either of the situations above.
+
+.. image:: ../images/screen12_edit_screen_overview.png
+
+* When editing an existing page the title of the page being edited is displayed at the top of the page.
+* The current status of the page is displayed in the top-right.
+* You can change the title of the page by clicking into the title field.
+* When you are typing into a field, help text is often displayed on the right-hand side of the screen.

docs/editor_manual/finding_your_way_around/index.rst

@@ -0,0 +1,12 @@
+Finding your way around
+=======================
+
+This section describes the different pages that you will see as you navigate around the CMS, and how you can find the content that you are looking for.
+
+.. toctree::
+   :maxdepth: 3
+
+   the_dashboard
+   the_explorer_menu
+   using_search
+   the_explorer_page

docs/editor_manual/finding_your_way_around/the_dashboard.rst

@@ -0,0 +1,30 @@
+The Dashboard
+~~~~~~~~~~~~~
+
+.. MAKE CHANGES TO INCLUDE MODERATION//
+
+The Dashboard provides information on:
+
+* The number of pages, images, and documents currently held in the Wagtail CMS
+* Any pages currently awaiting moderation (if you have these privileges)
+* Your most recently edited pages
+
+You can return to the Dashboard at any time by clicking the Wagtail log in the top-left of the screen.
+
+.. image:: ../../images/screen02_dashboard_editor.png
+
+- Clicking the logo returns you to your Dashboard.
+- Thes stats at the top of the page describe the total amount of content on the CMS (just for fun!).
+- The *Pages awaiting moderation* table will only displayed if you have moderator or administrator privileges
+
+  - Clicking the name of a page will take you to the ‘Edit page’ interface for this page.
+  - Clicking approve or reject will either change the page status to live or return the page to draft status. An email will be sent to the creator of the page giving the result of moderation either way.
+  - The *Parent* column tells you what the parent page of the page awaiting moderation is called. Clicking the parent page name will take you to its Edit page.
+  
+- The *Your most recent edits* table displays the five pages that you most recently edited.
+- The date column displays the date that you edited the page. Hover your mouse over the date for a more exact time/date.
+- The status column displays the current status of the page. A page will have on one of four statuses:
+
+  - Live: Published and accessible to website visitors
+  - Draft:  Not live on the website.
+  - Live + Draft: A version of the page is live, but a newer version is in draft mode.

docs/editor_manual/finding_your_way_around/the_explorer_menu.rst

@@ -0,0 +1,11 @@
+The Explorer menu
+~~~~~~~~~~~~~~~~~
+
+.. image:: ../../images/screen03_explorer_menu.png
+
+* Click the Explorer button in the sidebar to open the site explorer. This allows you to navigate through the tree-structure of the site.
+* Clicking the name of a page will take you to the Explorer page for that section (see below). NOTE: The site explorer only displays pages which themselves have child pages. To see and edit the child pages you should click the name of the parent page in the site explorer.
+* Clicking the green arrow displays the sub-sections (see below).
+* Clicking the back button takes you back to the parent section.
+* Again, clicking the section title takes you to the Explorer page.
+* Clicking further arrows takes you deeper into the tree.

docs/editor_manual/finding_your_way_around/the_explorer_page.rst

@@ -0,0 +1,32 @@
+The Explorer page
+~~~~~~~~~~~~~~~~~
+
+The Explorer page allows you to view the a page's children and perform actions on them. From here you can publish/unpublish pages, move pages to other sections, drill down further into the content tree, or reorder pages under the parent for the purposes of display in menus.
+
+
+.. image:: ../../images/screen05_explorer_page.png
+
+* The name of the section you are looking at is displayed below the breadcrumb (the row of page names beginning with the home icon). Each section is also itself a page (in this case the homepage). Clicking the title of the section takes you to the Edit screen for the section page.
+* As the heading suggests, below are the child pages of the section. Clicking the titles of each child page will take you to its Edit screen.
+
+.. image:: ../../images/screen06_explorer_page_arrow.png
+
+* Clicking the arrows will display a further level of child pages.
+
+.. image:: ../../images/screen07_explorer_page_breadcrumb.png
+
+* As you drill down through the site the breadcrumb (the row of pages beginning with the home icon) will display the path you have taken. Clicking on the page titles in the breadcrumb will take you to the Explorer screen for that page.
+
+.. image:: ../../images/screen08_add_page_button.png
+
+* To add further child pages press the Add child page button below the parent page title. You can view the parent page on the live site by pressing the View live button. The Move button will take you to the Move page screen where you can reposition the page and all its child pages in the site structure.
+* Similar buttons are available for each child page. These are made visible on hover.
+
+Reordering pages
+________________
+
+.. image:: ../../images/screen08.5_reorder_page_handles.png
+
+* Clicking the icon to the far left of the child pages table will enable the reordering handles. This allows you to reorder the way that content displays in the main menu of your website.
+* Reorder by dragging the pages by the handles on the far left (the icon made up of 8 dots).
+* Your new order will be automatically saved each time you drag and drop an item.

docs/editor_manual/finding_your_way_around/using_search.rst

@@ -0,0 +1,8 @@
+Using search
+~~~~~~~~~~~~
+
+.. image:: ../../images/screen04_search_screen.png
+
+* A very easy way to find the page that you want is to use the main search feature, accessible from the left-hand menu.
+* Simply type in part or all of the name of the page you are looking for, and the results below will automatically update as you type.
+* Clicking the page title in the results will take you to the Edit page for that result. You can differentiate between similar named pages using the Parent column, which tells you what the parent page of that page is.

docs/editor_manual/getting_started.rst

@@ -0,0 +1,18 @@
+Getting started
+~~~~~~~~~~~~~~~
+
+The Wagtail demo site
+_____________________
+
+This examples in this document are based on the `Wagtail demo site <https://github.com/torchbox/wagtaildemo/>`_. However, the instructions are general enough as to be applicable to any Wagtail site. If you want to use the demo site you can find installation and launch instructions on its `Github <https://github.com/torchbox/wagtaildemo/>`_ page.
+
+For the purposes of this documentation we will be using the URL, **www.example.com**, to represent the root (homepage) of your website. 
+
+Logging in
+__________
+
+* The first port of call for an editor is the login page for the administrator interface.
+* Access this by adding **/admin** onto the end of your root URL (e.g. www.example.com/admin).
+* Enter your username and password and click **Sign in**.
+
+.. image:: ../images/screen01_login.png

docs/editor_manual/index.rst

@@ -0,0 +1,16 @@
+Using Wagtail: an Editor's guide
+================================
+
+This section of the documentation is written for the users of a Wagtail-powered site. That is, the content editors, moderators and administrators who will be running things on a day-to-day basis.
+
+**NOTE:** This section of the documentation is currently in draft status.
+
+.. toctree::
+   :maxdepth: 3
+
+   intro
+   getting_started
+   finding_your_way_around/index
+   new_pages/index
+   editing_existing_pages
+   documents_images_snippets/index

docs/editor_manual/intro.rst

@@ -0,0 +1,13 @@
+Introduction
+------------
+
+`Wagtail <http://www.wagtail.io>`_ is a new open source content management system (CMS) developed by `Torchbox <http://www.torchbox.com>`_. It is built on the Django framework and designed to be super easy to use for both developers and editors.
+
+This documentation will explain how to:
+
+-  navigate the main user interface of Wagtail
+-  create pages of all different types
+-  modify, save, publish and unpublish pages
+-  how to set up users, and provide them with specific roles to create a publishing workflow
+-  upload, edit and include images and documents
+-  ... and more!

docs/editor_manual/new_pages/adding_multiple_items.rst

@@ -0,0 +1,17 @@
+Adding multiple items
+~~~~~~~~~~~~~~~~~~~~~
+
+A common feature of Wagtail is the ability to add more than one of a particular type of field or item. For example, you can add as many carousel items or related links as you wish.
+
+.. image:: ../../images/screen24_multiple_items_closed.png
+
+* Whenever you see the white cross in the green circle illustrated here it means you can add multiple objects or items to a page. Clicking the icon will display the fields required for that piece of content. The image below demonstrates this with a *Related link* item.
+
+.. image:: ../../images/screen25_multiple_items_open.png
+
+* You can delete an individual item by pressing the trash can in the top-right.
+* You can add more items by clicking the link with the white cross again.
+
+.. image:: ../../images/screen26_reordering_multiple_items.png
+
+4. You can reorder your multiple items using the up and down arrows. Doing this will affect the order in which they are display on the live page.

docs/editor_manual/new_pages/creating_body_content.rst

@@ -0,0 +1,40 @@
+Creating page body content
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The majority of the body content within a page will be created within text fields.
+
+There are two types of text entry fields you will see when creating a page. Some, like *Page title* are basic text fields come with no formatting options. This is because all titles display the same across a single page type. Others, *Body* for example, require more formatting, and so a set of tools are provided for this purpose. These are referred to as rich text fields. 
+
+So, when you click into certain fields, for example the *Body* field, you will be presented with a set of tools which allow you to format and style your text. These tools also allow you to insert links, images, videos clips and links to documents.
+
+.. image:: ../../images/screen11_rich_text_field.png
+
+Below is a summary of what the different buttons represent:
+
+.. image:: ../../images/screen11.1_bold_italic.png
+
+**Bold / Italic:**  Either click then type for bold or italic, or highlight and select to convert existing text to bold or italic.
+
+.. image:: ../../images/screen11.2_formatting_options.png
+
+**Paragraph / heading levels:**  Clicking into a paragraph and selecting one of these options will change the level of the text. H1 is not included as this is reserved for the page title.
+
+.. image:: ../../images/screen11.3_lists.png
+
+**Bulleted and numbered lists**
+
+.. image:: ../../images/screen11.4_horizontal_rule.png
+
+**Horizontal rule:** Creates a horizontal line at the position of the cursor. If inserted inside a paragraph it will split the paragraph into two seperate paragraphs.
+
+.. image:: ../../images/screen11.5_undo_redo.png
+
+**Undo / redo:** As expected will undo or redo the latest actions. Never use the your browser's back button when attempting to undo changes as this could lead to errors. Either use this undo button, or the usual keyboard shortcut, CTRL+Z.
+
+.. image:: ../../images/screen11.6_images_videos.png
+
+**Insert image / video:** Allows you to insert an image or video into the rich text field. See Inserting images and videos section for more details. .. insert links for images and videos here>>
+
+.. image:: ../../images/screen11.7_links_docs.png
+
+**Insert link / document:** Allows you to insert a link or a document into the rich text field. See Inserting links and Inserting documents for more details. .. insert links to Links and documents sections>>

docs/editor_manual/new_pages/index.rst

@@ -0,0 +1,22 @@
+Creating new pages
+~~~~~~~~~~~~~~~~~~
+
+.. image:: ../../images/screen08_add_page_button.png
+
+Create new pages by clicking the Add child page. This creates a child page of the section you are currently in. In this case a child page of the Homepage.
+
+.. ADD IN OTHER WAYS A CHILD PAGE CAN BE ADDED?>>
+
+.. toctree::
+   :maxdepth: 3
+
+   selecting_a_page_type
+   creating_body_content
+   inserting_images
+   inserting_links
+   inserting_videos
+   inserting_documents
+   adding_multiple_items
+   required_fields
+   the_promote_tab
+   previewing_and_submitting_for_moderation

docs/editor_manual/new_pages/inserting_documents.rst

@@ -0,0 +1,10 @@
+Inserting links to documents into body text
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. image:: ../../images/screen27_docs_icon.png
+
+It is possible to insert links to documents held in the CMS into the body text of a web page by clicking the button above in the Body field.
+
+The process for doing this is the same as when inserting an image. You are given the choice of either choosing a document from the CMS, or uploading a new document.
+
+.. image:: ../../images/screen28_docs_form.png

docs/editor_manual/new_pages/inserting_images.rst

@@ -0,0 +1,72 @@
+Inserting images and videos in a page
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+There will obviously be many instances in which you will want to add images to a page. There may be multiple ways in which to add an image to a page, depending on the setup of the site that you work on. For example, the Wagtail demo standard page type has two ways to insert images.
+
+* In the main carousel, or…
+* Within the body of the page
+
+Inserting images into the carousel
+__________________________________
+
+The carousel is where the main, featured images and videos associated with a page should be displayed.
+
+.. image:: ../../images/screen14_add_carousel_button.png
+
+* To insert a carousel item click the Add carousel content link in the Carousel content section.
+
+.. image:: ../../images/screen15_carousel_form.png
+
+* You can then insert an image by clicking the *Choose an image* button.
+* It is also possible to add videos to a carousel. Simply copy and paste the web address for the video (either YouTube or Vimeo) into the *Embed URL* field and click Insert. A poster image for the video can also be uploaded or selected from the CMS. This is the image displayed before a user has clicked play on the video.
+* The *Caption* field allows you to enter a caption to be displayed with your image. This caption also acts as the 'Alternative text' or Alt text for your image. This is a small piece of invisible code that is used by screen readers that enable visually impaired users to hear a description of the image.
+* The external link field allows you to enter a web address for pages not within your website.
+* Or you can select an internal page using the page chooser (see below for info on the page chooser).
+* You can add more items into the same carousel by clicking the Add carousel content link again. Please see Adding multiple items section below for help with removing or ordering carousel items.
+
+Choosing an image to insert
+___________________________
+
+You have two options when selecting an image to insert:
+
+#. Selecting an image from the existing image library, or…
+#. Uploading a new image to the CMS
+
+When you click the *Choose an image* button you will be presented with a pop-up with two tabs at the top. The first, Search, allows you to search and select from the library. The second, *Upload*, allows you to upload a new image.
+
+**Choosing an image from the image library**
+
+The image below demonstrates finding and  inserting an image that is already present in the CMS image library.
+
+.. image:: ../../images/screen16_selecting_image_from_library.png
+
+#. Typing into the search box will automatically display the results below.
+#. Clicking one of the Popular tags will filter the search results by that tag.
+#. Clicking an image will take you to the Choose a format window (see image below).
+
+**Uploading a new image to the CMS**
+
+.. image:: ../../images/screen17_upload_image.png
+
+#. You must include an image title for your uploaded image
+#. Click the *Choose file* button to choose an image from your computer.
+#. This *Tags* allows you to associate tags with the image you are uploading. This allows them to be more easily found when searching. Each tag should be separated by a space. Good practice for creating multiple word tags is to use an underscore between each word (e.g. western_yellow_wagtail).
+#. Click *Upload* to insert the uploaded image into the carousel. The image will also be added to the main CMS image library for reuse in other content.
+
+Inserting images into the body text
+___________________________________
+
+Images can also be inserted into the body text of a page. When editing the Body field of a standard page, click the image illustrated above. You will then be presented with the same options as for inserting images into the main carousel.
+
+In addition, the Wagtail Demo site allows you to chose an aligmnent for you image.
+
+.. image:: ../../images/screen18_image_alignment.png
+
+#. You can select how the image is displayed by selecting one of the format options.
+#. In the Wagtail Demo site, images inserted into the body text do not have embeded captions (these should be added as regular body text). However you must still provide specific alt text for your image.
+
+The aligmnents available are described below:
+
+* **Full width:** Image will be inserted using the full width of the text area.
+* **Half-width left/right aligned:** Inserts the image at half the width of the text area. If inserted in a block of text the text will wrap around the image. If two half-width images are inserted together they will display next to each other.
+

docs/editor_manual/new_pages/inserting_links.rst

@@ -0,0 +1,18 @@
+Inserting links in a page
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Similar to images, there are a variety of points at which you will want to add links. The most common place to insert a link will be in the body text of a page. You can insert a link into the body text by clicking the **Insert link** button in the rich text toolbar.
+
+Whichever way you insert a link, you will be presented with the form displayed below.
+
+.. image:: ../../images/screen19_link_form.png
+
+* Search for an existing page to link to using the search bar at the top of the pop-up.
+* Below the search bar you can select the type of link you want to insert. The following types are available:
+
+  * Internal link: A link to an existing page within the RCA website.
+  * External link: A link to a page on another website.
+  * Email link: A link that will open the users default email client with the email address prepopulated.
+
+* You can also navigate through the website to find an internal link via the explorer.
+

docs/editor_manual/new_pages/inserting_videos.rst

@@ -0,0 +1,12 @@
+Inserting videos into body content
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+As well as inserting videos into a carousel, Wagtail's rich text fields allow you to add videos into the body of a page by clicking the *Add video* button in the toolbar.
+
+.. image:: ../../images/screen20_insert_video_form.png	
+
+* Copy and paste the web address for the video (either YouTube or Vimeo) into the URL field and click Insert.
+
+.. image:: ../../images/screen21_video_in_editor.png	
+
+* A placeholder with the name of the video and a screenshot will be inserted into the text area. Clicking the X in the top corner will remove the video.

docs/editor_manual/new_pages/previewing_and_submitting_for_moderation.rst

@@ -0,0 +1,12 @@
+Previewing and submitting pages for moderation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Save/Preview/Submit for moderation menu is always present at the bottom of the page edit/creation screen. The menu allows you to perform the following actions, dependent on whether you are an editor, moderator or administrator:
+
+* **Save draft:** Saves your current changes but doesn’t submit the page for moderation and so won’t be published. (all roles)
+* **Submit for moderation:** Saves your current changes and submits the page for moderation. A moderator will be notified and they will then either publish or reject the page. (all roles)
+* **Preview:** Opens a new window displaying the page as it would look if published, but does not save your changes or submit the page for moderation. (all roles)
+* **Publish/Unpublish:** Clicking either the *Publish* or *Unpublish* buttons will take you to a confirmation screen asking you to confirm that you wish to publish or unpublish this page. If a page is published it will be accessible from its specific URL and will also be displayed in site search results. (moderators and administrators only)
+* **Delete:** Clicking this button will take you to a confirmation screen asking you to confirm that you wish to delete the current page. Be sure that this is actually what you want to do, as deleted pages are not recoverable. In many situations simply unpublishing the page will be enough. (moderators and administrators only)
+
+.. image:: ../../images/screen13_publish_menu.png

docs/editor_manual/new_pages/required_fields.rst

@@ -0,0 +1,11 @@
+Required fields
+~~~~~~~~~~~~~~~
+
+* Fields marked with an asterisk are required. You will not be able to save a draft or submit the page for moderation without these fields being completed.
+
+..  image:: ../../images/screen22_required_field.png
+
+* If you try to save/submit the page with some required fields not filled out, you will see the error displayed here.
+* The number of validation errors for each of the *Promote* and *Content* tabs will appear in a red circle, and the text, 'This field is required', will appear below each field that must be completed.
+
+..  image:: ../../images/screen23_validation_error.png

docs/editor_manual/new_pages/selecting_a_page_type.rst

@@ -0,0 +1,12 @@
+Selecting a page type
+~~~~~~~~~~~~~~~~~~~~~
+
+.. image:: ../../images/screen09_page_type_selection.png
+
+* On the left of the page chooser screen are listed all the types of pages that you can create. Clicking the page type name will take you to the Create new page screen for that page type (see below).
+* Clicking the *View all … pages* links on the right will display all the pages that exist on the website of this type. This is to help you judge what type of page you will need to complete your task.
+
+.. image:: ../../images/screen10_blank_page_edit_screen.png
+
+* Once you’ve selected a page type you will be presented with a blank New page screen.
+* Click into the areas below each field's heading to start entering content.

docs/editor_manual/new_pages/the_promote_tab.rst

@@ -0,0 +1,16 @@
+The Promote tab
+~~~~~~~~~~~~~~~
+
+A common feature of the *Edit* pages for all page types is the two tabs at the top of the screen. The first, Content, is where you build the content of the page itself.
+
+The second, *Promote*, is where you can set all the 'metadata' (data about data!) for the page. Below is a description of all the possible fields in the promote tab and what they do.
+
+* **Page title:** An optional, search-engine friendly page title. This is the title that appears in the tab of your browser window. It is also the title that would appear in a search engine if the page was returned as part of a set of search results.
+* **Slug:** The last part of the web address for the page. E.g. the slug for a blog page called 'The best things on the web' would be the-best-things-on-the-web (www.example.com/blog/the-best-things-on-the-web). This is autogenerated from the main page title set in the Content tab. This can be overridden by adding a new slug into the field. Slugs should be entirely lowercase, with words separated by hyphens (-).
+* **Show in menus:** Ticking this box will ensure that the page is included in automatically generated menus on your site. Note: Pages will only display in menus if all of its parent pages also have *Show in menus* ticked.
+* **Search description:** This field allows you to add text that will be displayed if the page appears in search results. This is especially usefull to distinguish between similarly named pages.
+* **Feed image:** This is the image displayed in content feeds, such as the thumbnails on the blog listing page. This optional image is most often used when the primary image on a page is in a format that would not display well in a content feed.
+
+..  ^^ CHECK THAT THIS IS RELEVANT FOR WAGTAIL DEMO >>
+
+..  ADD IN IMAGE OF PROMOTE TAB >>

docs/gettingstarted.rst

@@ -139,7 +139,7 @@ with a regular Django project.
 .. _Elasticsearch: http://www.elasticsearch.org
 
 _`Remove the demo app`
-~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~
 
 Once you've experimented with the demo app and are ready to build your pages via your own app you can remove the demo app if you choose.
 

docs/index.rst

@@ -4,7 +4,7 @@ Welcome to Wagtail's documentation
 Wagtail is a modern, flexible CMS, built on Django.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 3
 
    gettingstarted
    building_your_site
@@ -14,3 +14,4 @@ Wagtail is a modern, flexible CMS, built on Django.
    contributing
    support
    roadmap
+   editor_manual/index