Merge ~jugmac00/lpci:known-issues into lpci:main

[Jürgen Gmach]

Add support page

[Colin Watson (cjwatson)]

I think you forgot a `git add` here?

[Jürgen Gmach (jugmac00)]

Indeed - sorry for that.

I have a variety of .launchpad.yaml files in my working directory...

If you do not mind, I will create a follow-up MP with a gitignore for a test-configuration folder.

[Colin Watson (cjwatson)]

review: Approve

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 64753c6..cf95e75 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -86,10 +86,3 @@ Build the documentation locally.
     <https://lpcraft.readthedocs.io/en/latest/>`_ online,
     after having pushed your changes to the repository, you need to trigger a
     manual build on the project's dashboard on https://readthedocs.org.
-
-Getting help
-------------
-
-If you find bugs in this package, you can report them here:
-
-    https://launchpad.net/lpcraft
diff --git a/docs/cli-interface.rst b/docs/cli-interface.rst
index 3edffa0..afb6907 100644
--- a/docs/cli-interface.rst
+++ b/docs/cli-interface.rst
@@ -1,6 +1,6 @@
-=======================
-lpcraft - CLI interface
-=======================
+=============
+CLI interface
+=============
 
 Please note that this is only a small selection of the available commands and
 options.
diff --git a/docs/index.rst b/docs/index.rst
index 9e8dfce..488b44c 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -58,5 +58,6 @@ Example configuration
     cli-interface
     plugins
     CONTRIBUTING
+    support
     release-process
     NEWS
diff --git a/docs/support.rst b/docs/support.rst
new file mode 100644
index 0000000..5746f8d
--- /dev/null
+++ b/docs/support.rst
@@ -0,0 +1,43 @@
+Support
+=======
+
+Getting help
+------------
+
+In case you need help, do not hesitate to reach out to us:
+
+    https://answers.launchpad.net/lpcraft
+
+If you work at Canonical, you can also visit the ~Launchpad channel on
+Mattermost.
+
+
+Bugs and feature requests
+-------------------------
+
+If you encounter a bug or you would like to have a new feature implemented,
+please report them at https://bugs.launchpad.net/lpcraft.
+
+
+Known issues
+------------
+
+Apart from the currently open
+`bug reports <https://bugs.launchpad.net/lpcraft>`_,
+there are the following known issues for which there is no known solution:
+
+- In order to keep the source tree clean,
+  lpcraft mirrors the contents of the project into the lxd container
+  (``/build/lpcraft/project/``).
+
+  This may have unexpected side effects when your current work tree is not
+  clean.
+
+  This may also be a reason that the result you get when you run ``lpcraft``
+  on your machine and on CI may diverge.
+
+  In order to ensure that you can use ``lpcraft`` to test code that has not yet
+  been committed,
+  we do not currently intend to change this behaviour.
+  However, you can simulate the behaviour of a CI run by making a fresh clone
+  of your branch and running ``lpcraft`` there.