1 files changed, 54 insertions, 0 deletions
diff --git a/doc/Bugs.asciidoc b/doc/Bugs.asciidoc
new file mode 100644
index 0000000..057fae9
--- /dev/null
+++ b/doc/Bugs.asciidoc
@@ -0,0 +1,54 @@
+== Reporting bugs
+
+=== What to include
+A bug report should contain these 4 things:
+
+==== Environment
+This includes program version; operating system used; version of Qt or other
+libraries; any relevant information if you built from source.
+
+==== Steps to reproduce
+Give detailed steps on how to reproduce the problem. Start from the beginning,
+mention the actions involved, and be verbose.
+
+==== Expected result
+It's important to include the result you were expecting, as it might differ
+from the way the program was designed to work.
+
+==== Actual result
+It is also important to include a good description of the buggy behaviour
+itself as well, because it's possible that following your steps on a different
+system doesn't reproduce the issue.
+
+Send bug reports to _aqua at iserlohn dash fortress dot net_.
+
+_Adapted from the guide in the texmate repository._
+
+== Known bugs
+
+=== databases-incognito in home
+https://bugreports.qt.io/browse/QTBUG-62957
+
+=== loadFinished is not always emitted when loading is finished
+https://bugreports.qt.io/browse/QTBUG-65223
+
+=== QWebEngineView setUrl()/load() methods in some case divide page in two parts
+https://bugreports.qt.io/browse/QTBUG-68224
+
+Only affects Qt 5.11.0. Set __QTBUG_68224_WORKAROUND__.
+
+=== Wayland bugs
+
+=== mainwindow.maximized doesn't work
+setWindowState(Qt::WindowMaximized) has no effect on KDE/Wayland:
+https://community.kde.org/Plasma/Wayland_Showstoppers
+
+=== Windows bugs
+
+=== stdout and stderr
+Starting the application with some command-line options (like --version,
+--help, etc) causes the application to 'stall' on exit.
+
+Starting the application from the command prompt returns after launch, but
+continues outputting stdout and stderr to it.
+