Move and expand text into usage section

docs/source/usage/organising_project.rst

@@ -0,0 +1,118 @@
+.. _docs_usage_project:
+
+***********************
+Organising Your Project
+***********************
+
+Your project is organised into a set of top level folders called "Root Folders", which each have
+specific meaning in the project. Your project documents and notes are stored under these root
+folders. All the content of your project is available in the **Project Content** panel on the left
+side of the main window.
+
+.. figure:: images/fig_project_tree.png
+
+   The **Project Content** tree populated with example documents.
+
+Each line in the project tree shows the label of each item, its word count (or alternatively
+character count), an active/inactive icon (see :ref:`docs_features_active`), and a custom status
+icon (see :ref:`docs_features_status`).
+
+You can add, view and edit the documents in the project tree by right-clicking on them. Some
+features are also located in the buttons along the top next to the **Project Content** label.
+
+
+.. _docs_usage_project_roots:
+
+How Root Folders Work
+=====================
+
+Projects are structured into a set of top level folders called "Root Folders". They are visible in
+the project tree at the left side of the main window.
+
+The documents that make up your story go into a root folder of type **Novel**. Your notes go into
+the other root folders. These other root folder types are separated into types depending on what
+kind of notes go into them. This is not only for organisation. It also matters to how you can
+reference these notes later. We will come back to this in the :ref:`docs_usage_tags_refs` section.
+
+A new project may not have all of the root folders present, but you can add the ones you want from
+the project tree tool bar.
+
+The intended usage of each type of root folder is listed below. However, aside from the **Novel**
+folder, no restrictions are applied by the application on what you put in them. You can use them
+however you want.
+
+
+Root Folder Types
+-----------------
+
+**Novel**
+   This is where you put the documents that are part of your story. You can create multiple Novel
+   folders if you wish, but various parts of the application assumes each Novel folder belong to
+   one novel.
+
+   The Novel folder is somewhat special in that it can contain documents for chapters, scenes and
+   story partitions. How this is indicated is covered in the section :ref:`docs_usage_headers`.
+
+**Plot**
+   This is where you can keep notes and outlines of your story plots. Such notes can be
+   particularly useful if you have outlines for sub plot. You can make references to these subplots
+   from the scene documents, which makes it easier to track story progress.
+
+**Characters**
+   Character notes go in this root folder type. For your main characters, you may want to make one
+   document for each character. For smaller characters you can put multiple into the same document.
+   In your chapters and scenes you can reference these character notes as Point of View or Focus
+   characters.
+
+**Locations**
+   The locations where your story takes place can be documented here. This, together with Plot and
+   Characters are the particularly useful story elements to track, and to reference from your
+   chapter and scene documents.
+
+**Timeline**
+   If the story has multiple plot timelines or jumps in time within the same plot, this folder type
+   can be used to track this.
+
+**Objects**
+   Important objects in the story, for instance physical objects that change hands often, can be
+   tracked here.
+
+**Entities**
+   Does your plot have many powerful organisations or companies? Or other entities that are part of
+   the plot? They can be organised here.
+
+**Custom**
+   The custom root folder type can be used for tracking anything else not covered by the above
+   options.
+
+**Archive**
+   If you don't want to delete a document, or put it in the **Trash** folder where it may be
+   deleted, but still want it out of your main project, you can put it in this folder. The contents
+   of the document will be ignored by the scanner that looks for tags, and it will be ignored in
+   any outline view and in your manuscript.
+
+**Trash**
+   This folder behaves like you expect. Anything dropped in here can be deleted permanently from
+   the project, and the content doesn't show up anywhere else in novelWriter.
+
+The root folders are closely tied to the tags and reference system. Each folder type except
+**Archive** and **Trash** corresponds to one or more categories of tags that can be used to
+reference the content in them. See :ref:`docs_usage_tags_refs` for more details.
+
+.. tip::
+
+   The root folders have standard names, but you can rename them to whatever you want.
+
+
+.. _docs_usage_project_folders:
+
+Regular Folders
+===============
+
+Regular folders, those that are not root folders, have no structural significance to the project.
+When novelWriter is processing the documents in a project, like for instance when you create a
+manuscript from it, these folders are ignored. Only the order of the documents themselves matter.
+
+The folders are there purely as a way for you to organise the documents in meaningful sections and
+to be able to collapse and hide them in the project tree when you're not working on those
+documents.