diff --git a/docs/reference/gtk/question_index.sgml b/docs/reference/gtk/question_index.sgml
index 28a470dd1c..9f8af36241 100644
--- a/docs/reference/gtk/question_index.sgml
+++ b/docs/reference/gtk/question_index.sgml
@@ -77,8 +77,8 @@ specific widgets and functions.
If you have a question not covered in the manual, feel free to
ask on the mailing lists and please file a bug report against the
-documentation.
+url="https://gitlab.gnome.org/GNOME/gtk/issues/new">file a bug report
+against the documentation.
@@ -105,8 +105,8 @@ state (explained in its documentation).
For strings returned from functions, they will be declared "const"
if they should not be freed. Non-const strings should be
freed with g_free(). Arrays follow the same rule. If you find an
-undocumented exception to the rules, please report a bug to https://bugzilla.gnome.org.
+undocumented exception to the rules, please
+file a bug report.
diff --git a/docs/reference/gtk/resources.sgml b/docs/reference/gtk/resources.sgml
index 05e18084d7..9a129a7994 100644
--- a/docs/reference/gtk/resources.sgml
+++ b/docs/reference/gtk/resources.sgml
@@ -17,15 +17,14 @@ Getting help with GTK+
-Filing a bug report or feature request
+Opening a bug or feature request
If you encounter a bug, misfeature, or missing feature in GTK+, please
-file a bug report on
-https://bugzilla.gnome.org.
-We'd also appreciate reports of incomplete or misleading information in
-the GTK+ documentation; file those against the "docs" component of the "gtk+"
-product in Bugzilla.
+file a bug report on our
+GitLab project.
+You should also file issues if the documentation is out of date with the
+existing API, or unclear.
@@ -37,29 +36,34 @@ discussed, we'll add a note to that effect in the report.
The bug tracker should definitely be used for feature requests, it's
-not only for bugs. We track all GTK+ development in Bugzilla, so it's
-the way to be sure the GTK+ developers won't forget about an issue.
+not only for bugs. We track all GTK+ development in GitLab, to ensure
+that nothing gets lost.
-Submitting Patches
+Working on GTK+
-If you develop a bugfix or enhancement for GTK+, please file that in
-Bugzilla as well. Bugzilla allows you to attach files; please attach a
-patch generated by the diff utility, using the
- option to make the patch more readable. All patches
-must be offered under the terms of the GNU LGPL license, so be sure you
-are authorized to give us the patch under those terms.
+If you develop a bugfix or enhancement for GTK+, please open a merge
+request in GitLab as well. You should not attach patches to an issue,
+or describe the fix as a comment. Merge requests allow us to build
+GTK+ with your code applied, and run the test suite, on multiple platforms
+and architectures, and verify that nothing breaks. They also allow us to
+do proper code reviews, so we can iterate over the changes.
-If you want to discuss your patch before or after developing it, mail
-gtk-devel-list@gnome.org.
-But be sure to file the Bugzilla report as well; if the patch is only on the
-list and not in Bugzilla, it's likely to slip through the cracks.
+You should follow the contribution guide
+for GTK+, available on GitLab.
+
+
+
+If you want to discuss your approach before or after working on it,
+send and email to gtk-devel-list@gnome.org.
+You should not send a patch to the mailing list, as it will inevitably
+get lost, or forgotten. Always open a merge request.