<chapter id="gtk-resources">
  <title>Contact information and bug reports</title>
  <sect1>
    <title>Opening a bug or feature request</title>
    <para>
      If you encounter a bug, misfeature, or missing feature in GTK,
      please file a bug report on our
      <ulink url="https://gitlab.gnome.org/GNOME/gtk/issues/new">GitLab
      project</ulink>. You should also file issues if the documentation
      is out of date with the existing API, or unclear.
    </para>
    <para>
      Don’t hesitate to file a bug report, even if you think we may know
      about it already, or aren’t sure of the details. Just give us as
      much information as you have, and if it’s already fixed or has
      already been discussed, we’ll add a note to that effect in the
      report.
    </para>
    <para>
      The issue tracker should definitely be used for feature requests,
      it’s not only for bugs. We track all GTK development in GitLab, to
      ensure that nothing gets lost.
    </para>
  </sect1>
  <sect1>
    <title>Working on GTK</title>
    <para>
      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.
    </para>
    <para>
      You should follow the
      <ulink url="https://gitlab.gnome.org/GNOME/gtk/blob/master/CONTRIBUTING.md">contribution
      guide</ulink> for GTK, available on GitLab.
    </para>
    <para>
      If you want to discuss your approach before or after working on
      it, good ways to contact the GTK developers, apart from GitLab
      issues, are
    </para>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          the <link linkend="gtk"><type>gtk</type></link> IRC channel on irc.gnome.org
        </para>
      </listitem>
      <listitem>
        <para>
          the gtk tag on the
          <ulink url="https://discourse.gnome.org/tag/gtk">GNOME
          Discourse instance</ulink>
        </para>
      </listitem>
    </itemizedlist>
    <para>
      You should not send patches by email, as they will inevitably get
      lost, or forgotten. Always open a merge request.
    </para>
  </sect1>
</chapter>
