diff --git a/docs/contributing/debugging/debugging_a_minidump.rst b/docs/contributing/debugging/debugging_a_minidump.rst index 22e48b84e21e..6991aa2a2d13 100644 --- a/docs/contributing/debugging/debugging_a_minidump.rst +++ b/docs/contributing/debugging/debugging_a_minidump.rst @@ -31,9 +31,9 @@ access and where to find minidump files for crash reports, consult the Using the MS Visual Studio debugger ----------------------------------- -#. Set up the debugger to `use the Mozilla symbol - server `__ and `source - server `__\. +#. Set up the debugger to :ref:`use the Mozilla symbol + server ` and + :ref:`source server `. #. Double-click on the minidump file to open it in the debugger. #. When it loads, click the green icon in the visual studio debugger toolbar that looks like a play button. diff --git a/docs/contributing/debugging/understanding_crash_reports.rst b/docs/contributing/debugging/understanding_crash_reports.rst index e63de42975da..f840782254cf 100644 --- a/docs/contributing/debugging/understanding_crash_reports.rst +++ b/docs/contributing/debugging/understanding_crash_reports.rst @@ -317,8 +317,7 @@ See also - `A talk about understanding crash reports `__, by David Baron, from March 2016. -- `A guide to searching crash - reports `__ +- :ref:`A guide to searching crash reports` .. |Example fields in the "Details" tab of a crash report| image:: https://mdn.mozillademos.org/files/13579/Details1.png .. |Information relating to bug reports in the "Details" tab of a crash report| image:: https://mdn.mozillademos.org/files/13581/Details2.png diff --git a/docs/crash-reporting/crash-reporting.rst b/docs/crash-reporting/index.rst similarity index 50% rename from docs/crash-reporting/crash-reporting.rst rename to docs/crash-reporting/index.rst index 7be888d6f028..38addc9f4516 100644 --- a/docs/crash-reporting/crash-reporting.rst +++ b/docs/crash-reporting/index.rst @@ -20,44 +20,33 @@ Crash data submitted using the Mozilla Crash Reporter is located on a specific crash that you submitted, you first need to find the Crash ID that the server has assigned your crash. Type ``about:crashes`` into your location bar to get a page listing both submitted and unsubmitted -crash reports. For more information, see `How to get a stacktrace for a -bug report `__. +crash reports. For more information, see :ref:`How to get a stacktrace for a bug report`. Reports and queries ------------------- crash-stats has built-in reports of "topcrashes" for each release -grouped by signature. There is also a custom query tool which allows -users to limit searches on more precise information. +grouped by signature. There is also a `custom query tool `__ +which allows users to limit searches on more precise information. Finally, a set of Mozilla employees have access to directly query the underlying data in either SQL summary or using mapreduce on the storage -cluster. If you are interested in obtaining this advanced access, -contact `Gabriele Svelto `__. +cluster. If you are interested in obtaining this advanced access, read +`Crash Stats Documentation: Protected Data Access `__ See also -------- -- `Understanding crash - reports `__ -- `A guide to searching crash - reports `__ +- :ref:`Understanding crash reports` +- :ref:`A guide to searching crash reports` - `crash-stats `__ - `Crash pings (Telemetry) and crash reports (Socorro/Crash Stats) `__ -- `Building Firefox with Debug - Symbols `__ -- `Environment variables affecting crash - reporting `__ -- `Uploading Symbols to Mozilla's Symbol - Server `__ -- In-code documentation - - - `Crash - reporter `__ - - `Crash - manager `__ - - `Crash - ping `__ +- :ref:`Building with Debug Symbols` +- :ref:`Environment variables affecting crash reporting ` +- :ref:`Uploading symbols to Mozilla's symbol server` +- :ref:`Crash reporter` +- :ref:`Crash manager` +- :ref:`Crash ping` diff --git a/docs/crash-reporting/searching_crash_reports.rst b/docs/crash-reporting/searching_crash_reports.rst index ad5d78e3fd9a..88ccfe9e45a3 100644 --- a/docs/crash-reporting/searching_crash_reports.rst +++ b/docs/crash-reporting/searching_crash_reports.rst @@ -9,7 +9,7 @@ A guide to searching crash reports The Mozilla `crash-stats `__ site provides facilities for investigating large numbers of Firefox `crash -reports `__ . This guide to +reports `__. This guide to searching through crash reports may help you locate the crash reports that will help you find and fix the Firefox bug you're working on. @@ -38,7 +38,7 @@ by clicking on the "Super Search" link near the toolbar at the top right of any page in crash-stats. This brings up a search form like the one in the following screenshot. -|Results of a default search in crash-stats| +|Search in crash-stats| Fields are provided for four common search criteria: product, version, platform, and process type. The product field is pre-populated with @@ -246,7 +246,7 @@ documentation `__ for full details; note that it uses the term "aggregation" for grouping/faceting. -.. |Results of a default search in crash-stats| image:: img/super-search-form.png +.. |Search in crash-stats| image:: img/super-search-form.png .. |Results of a default search in crash-stats| image:: img/default-search-results.png .. |Results of a default search in crash-stats (crash reports tab)| image:: img/default-search-results2.png .. |crash-stats Super Search form with additional criteria| image:: img/super-search-form2.png diff --git a/docs/setup/contributing_code.rst b/docs/setup/contributing_code.rst index ec0022d53fa9..91a1264e0de5 100644 --- a/docs/setup/contributing_code.rst +++ b/docs/setup/contributing_code.rst @@ -74,12 +74,10 @@ We leave this in your hands. Here are some further resources to help: `https://developer.mozilla.org/docs/Developer_Guide `_ and its parent document, https://developer.mozilla.org/docs/Mozilla -- Our `reviewer - checklist `_ is very +- Our :ref:`reviewer checklist ` is very useful, if you have a patch near completion, and seek a favorable review -- Utilize our build tool - `Mach `_, its linting, +- Utilize our build tool :ref:`mach`, its linting, static analysis, and other code checking features Getting your code reviewed @@ -199,4 +197,3 @@ form: - `Mozilla platform development cheatsheet `_ (archive.org) - diff --git a/docs/setup/mach.rst b/docs/setup/mach.rst index 07871e8811f1..e6a5338702c5 100644 --- a/docs/setup/mach.rst +++ b/docs/setup/mach.rst @@ -44,9 +44,8 @@ Try building the tree: $ ./mach build -If you get error messages, make sure that you have all of the `build -requisites `__ -for your system. +If you get error messages, make sure that you have all of the :ref:`build +requisites ` for your system. If it works, you can look at compiler warnings: @@ -82,7 +81,7 @@ You run mach from the source directory, so you should be able to use your shell's tab completion to tab-complete paths to tests. Mach figures out how to execute the tests for you! -Check out the linting and analysis tools: +Check out the :ref:`linting` and :ref:`Static analysis` tools: .. code-block:: shell @@ -207,7 +206,7 @@ client.mk: warnings are currently detected. Do not rely on mach as a substitute for raw build output. - mach will invoke make in silent mode. This suppresses excessive - (often unncessary) output. + (often unnecessary) output. Is mach a build system? diff --git a/docs/setup/macos_build.rst b/docs/setup/macos_build.rst index 46e63438c5c9..d0760955a2a1 100644 --- a/docs/setup/macos_build.rst +++ b/docs/setup/macos_build.rst @@ -328,8 +328,7 @@ couple hundred megabytes of data over the internet. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In your checked out source tree create a new file, ``mozconfig``, which -will contain your build options. For more on this file, see `Configuring -Build Options `_. +will contain your build options. For more on this file, see :ref:`Configuring Build Options`. To get started quickly, create the file with the following contents: @@ -407,7 +406,7 @@ Software requirements These options are specific to Mozilla builds for macOS. For a more general overview of build options and the ``mozconfig`` file, see -`Configuring Build Options `_. For +:ref:`Configuring Build Options`. For specific information on configuring to build a universal binary, see `Mac OS X Universal Binaries `_. @@ -444,8 +443,8 @@ are intended to be added to your ``mozconfig`` file. ac_add_options --with-macos-sdk=/path/to/SDK - Official trunk builds use ``/Developer/SDKs/MacOSX10.11.sdk``. Check - ```build/macosx/universal/mozconfig.common`` `_ + Official trunk builds use `/Developer/SDKs/MacOSX10.11.sdk`. Check + `build/macosx/universal/mozconfig.common `__ for the SDK version used for official builds of any particular source release. @@ -484,4 +483,3 @@ Troubleshooting configuration file you're using for your chosen shell. Removing all modifications and then re-adding them one-by-one can narrow down problems. - diff --git a/moz.build b/moz.build index 61f6594c8ec4..71964dff8a6f 100644 --- a/moz.build +++ b/moz.build @@ -200,4 +200,6 @@ SPHINX_TREES['bug-mgmt'] = 'docs/bug-mgmt' SPHINX_TREES['setup'] = 'docs/setup' +SPHINX_TREES['crash-reporting'] = 'docs/crash-reporting' + include('build/templates.mozbuild') diff --git a/taskcluster/docs/mach.rst b/taskcluster/docs/mach.rst index 023f1d271dec..ccb4ce5ac904 100644 --- a/taskcluster/docs/mach.rst +++ b/taskcluster/docs/mach.rst @@ -1,5 +1,5 @@ -Mach commands -============= +Taskcluster Mach commands +========================= A number of mach subcommands are available aside from ``mach taskgraph decision`` to make this complex system more accessible to those trying to diff --git a/toolkit/components/telemetry/docs/data/crash-ping.rst b/toolkit/components/telemetry/docs/data/crash-ping.rst index b96aada9274e..72bd7bc1d036 100644 --- a/toolkit/components/telemetry/docs/data/crash-ping.rst +++ b/toolkit/components/telemetry/docs/data/crash-ping.rst @@ -1,6 +1,5 @@ - -"crash" ping -============ +Crash ping +========== This ping is captured after the main Firefox process crashes or after a child process process crashes, whether or not the crash report is submitted to @@ -14,7 +13,11 @@ successfully. The crash reporter client sends crash pings only for main process crashes whether or not the user also reports the crash. The crash reporter client will not send the crash ping if telemetry has been disabled in Firefox. -The environment block that is sent with this ping varies: if Firefox was running long enough to record the environment block before the crash, then the environment at the time of the crash will be recorded and ``hasCrashEnvironment`` will be true. If Firefox crashed before the environment was recorded, ``hasCrashEnvironment`` will be false and the recorded environment will be the environment at time of submission. +The environment block that is sent with this ping varies: if Firefox was running +long enough to record the environment block before the crash, then the environment +at the time of the crash will be recorded and ``hasCrashEnvironment`` will be true. +If Firefox crashed before the environment was recorded, ``hasCrashEnvironment`` will +be false and the recorded environment will be the environment at time of submission. The client ID is submitted with this ping. diff --git a/toolkit/docs/index.rst b/toolkit/docs/index.rst index fe85f7bd05e1..3403e842f174 100644 --- a/toolkit/docs/index.rst +++ b/toolkit/docs/index.rst @@ -8,6 +8,7 @@ This is the nascent documentation of the Toolkit code that is shared across Fire :maxdepth: 1 mozapps/extensions/addon-manager/index + crash-reporting/index components/crashes/crash-manager/index crashreporter/crashreporter/index components/featuregates/featuregates/index