CONTRIBUTING.md 2.46 KB
Newer Older
1
2
This document includes guidelines for submitting issue reports. This is kept
very short, so please read it before reporting your issue.
3

4
For tips for hacking on Epiphany, see the HACKING.md file.
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# Submitting an Issue Report?

Thanks for reporting your problem with Epiphany.

## Software versions

Please include the following in your report:

 * Epiphany version
 * WebKitGTK+ version
 * Operating system and version

Check the About dialog if you're not sure what Epiphany or WebKitGTK+ versions
you have.

## Web Content Bugs

This is the **wrong place** to report bugs with web content (e.g. incorrect page
rendering, broken JavaScript, problems with video playback, font issues, network
25
26
27
28
29
30
31
issues, web inspector issues, or generally anything at all wrong with a
website). These problems should all be reported directly on
[WebKit Bugzilla](https://bugs.webkit.org) instead. The Epiphany developers are
also WebKit developers, and we will see your WebKit bug reports so long as you
are careful to select the WebKitGTK+ Bugzilla component when reporting the
issue. Don't forget! Please also add the `[GTK]` prefix to the title of your
bug.
32
33
34

In general, only problems with the GTK+ user interface around the web content
view (e.g. menus, preferences dialog, window chrome, history, bookmarks, tabs)
35
36
or Epiphany features (e.g. Firefox Sync, adblocker, password manager, web apps)
should be reported on Epiphany's GitLab issue tracker.
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

Don't worry if you accidentally submit your report in the wrong place. This
happens all the time, since it's sometimes difficult to guess whether Epiphany
or WebKit is responsible for a bug. If we suspect an issue reported on the
Epiphany issue tracker is actually a WebKit bug, we will close it and ask you to
report the issue on WebKit Bugzilla instead.

## Crashes

If Epiphany crashed, then we really need a backtrace taken in gdb with `bt full`
in order to solve the problem. Be sure to install the necessary debuginfo
packages for all frames that appear in the crashing thread.
[Learn how to include a good backtrace.](https://wiki.gnome.org/Community/GettingInTouch/Bugzilla/GettingTraces)

If you see the message "Oops! Something went wrong while displaying this page,"
that means WebKit has crashed. Please follow the steps above to take a quality
backtrace for the WebKitWebProcess and to report it on WebKit Bugzilla (not on
Epiphany's GitLab).

We always appreciate crash reports that include a quality backtrace. Crash
reports without a useful backtrace will be closed.