Update docs

Author: vkbo

docs/source/usage/howto.rst

@@ -13,8 +13,8 @@ This is a list of hopefully helpful little tips on how to get the most out of no
    contribute, or start a discussion on the project's `Discussions Page`_.
 
 
-Managing the Project
-====================
+Your Project
+============
 
 .. dropdown:: How do I create a project from a template?
    :animate: fade-in-slide-down
@@ -42,9 +42,48 @@ Managing the Project
    Settings** from the respective configuration tabs. You can then import these labels in another
    project.
 
+.. dropdown:: How do I add introductory text to chapters?
+   :animate: fade-in-slide-down
+
+   Sometimes chapters have a short preface, like a brief piece of text or a quote to set the stage
+   before the first scene begins.
+
+   If you add separate files for chapters and scenes, the chapter file is the perfect place to add
+   such text. Separating chapter and scene files also allows you to make scene files child
+   documents of the chapter.
+
+.. dropdown:: How do I distinguishing between soft and hard scene breaks?
+   :animate: fade-in-slide-down
+
+   Depending on your writing style, you may need to separate between soft and hard scene breaks
+   within chapters. Like for instance if you switch point-of-view character often.
+
+   In such cases you may want to use different scene headings for hard and soft scene breaks. The
+   **Build Manuscript** tool will let you define a different format for scenes using the ``###``
+   and ``###!`` heading codes when you generate your manuscript. You can for instance add the
+   common "``* * *``" for hard breaks and select to hide soft scene breaks, which will just insert
+   an empty paragraph in their place. See :ref:`docs_ui_manuscript_settings` for more details.
+
+   .. versionadded:: 2.4
+
+.. dropdown:: How can I set the language for my manuscript?
+   :animate: fade-in-slide-down
+
+   The language set for manuscript documents like Open Document and Word Document is taken from
+   your project language setting in **Project Settings**. Only some languages are available here,
+   but you can override the language information by setting the "Override Document Language" value
+   in your Manuscript Build settings to a valid language code. The code uses the
+   `IETF BCP 47 language tag <https://en.wikipedia.org/wiki/IETF_language_tag>`__ format.
+
+   Examples: ``en`` for English, ``de`` for German, etc.
+
+   If you want to help add new languages to novelWriter, see: :ref:`docs_contributing`.
 
-Application Usage
-=================
+   .. versionadded:: 2.8
+
+
+The Application
+===============
 
 .. dropdown:: How can I increase the line height?
    :animate: fade-in-slide-down
@@ -91,34 +130,6 @@ Layout Tricks
    See :ref:`docs_usage_align_indent` for more details.
 
 
-Organising Your Text
-====================
-
-.. dropdown:: How do I add introductory text to chapters?
-   :animate: fade-in-slide-down
-
-   Sometimes chapters have a short preface, like a brief piece of text or a quote to set the stage
-   before the first scene begins.
-
-   If you add separate files for chapters and scenes, the chapter file is the perfect place to add
-   such text. Separating chapter and scene files also allows you to make scene files child
-   documents of the chapter.
-
-.. dropdown:: How do I distinguishing between soft and hard scene breaks?
-   :animate: fade-in-slide-down
-
-   Depending on your writing style, you may need to separate between soft and hard scene breaks
-   within chapters. Like for instance if you switch point-of-view character often.
-
-   In such cases you may want to use different scene headings for hard and soft scene breaks. The
-   **Build Manuscript** tool will let you define a different format for scenes using the ``###``
-   and ``###!`` heading codes when you generate your manuscript. You can for instance add the
-   common "``* * *``" for hard breaks and select to hide soft scene breaks, which will just insert
-   an empty paragraph in their place. See :ref:`docs_ui_manuscript_settings` for more details.
-
-   .. versionadded:: 2.4
-
-
 Other Tools
 ===========
 

docs/source/usage/introduction.rst

@@ -5,6 +5,8 @@ Introduction
 ************
 
 .. _Markdown: https://en.wikipedia.org/wiki/Markdown
+.. _Contributing Guide: https://github.com/vkbo/novelWriter/blob/main/CONTRIBUTING.md
+.. _Crowding: https://crowdin.com/project/novelwriter
 
 In a nutshell, novelWriter is a plain text editor that lets you organise one or more novels, and
 associated notes, as many smaller documents. You can at any time generate standard document formats
@@ -55,3 +57,22 @@ comments, and an auto-complete menu can help you here too. More about this later
    mainly intended for character profiles and plot outlines. It is recommended to use a proper
    note-taking tool for research. This is anyway more practical as you may use the same research
    for multiple projects.
+
+
+.. _docs_contributing:
+
+Contributing
+============
+
+This project relies on contributions to add new features. In particular, adding translations into
+other languages, or updating translations for existing languages, is particularly useful.
+
+For code contributions, please read the official `Contributing Guide`_.
+
+For translations, please use the project page on Crowdin_. For each language, there are two
+translation sets. One for the application itself, labelled "Main GUI". This is a fairly large
+dataset to translate. A smaller set called "Project Exports" is also available. The latter is what
+makes a language available in **Project Settings** in the application. It is a fairly small set to
+translate, and you can choose to translate only this set if you wish. If the language you wish to
+contribute to is not available in the list, you can message the maintainer on the Crowdin page to
+add new languages to the project.

docs/source/user_interface/manuscript.rst

@@ -136,6 +136,12 @@ Any text you add that isn't highlighted in colours will remain in your formatted
 You can preview the result of these format strings by clicking :guilabel:`Apply`, and then clicking
 :guilabel:`Preview` in the **Manuscript Build** tool main window.
 
+.. note::
+
+   The language used for generating chapter numbers is defined by the project language set in
+   **Project Settings**. This feature relies on translation files existing for each language.
+   If you want to help add new languages to novelWriter, see: :ref:`docs_contributing`.
+
 
 .. _docs_ui_manuscript_head_numbers: