diff options
Diffstat (limited to 'l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl')
-rw-r--r-- | l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl | 107 |
1 files changed, 107 insertions, 0 deletions
diff --git a/l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl b/l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl new file mode 100644 index 0000000000..0974cf7c6a --- /dev/null +++ b/l10n-en-GB/toolkit/toolkit/about/aboutGlean.ftl @@ -0,0 +1,107 @@ +# This Source Code Form is subject to the terms of the Mozilla Public +# License, v. 2.0. If a copy of the MPL was not distributed with this +# file, You can obtain one at http://mozilla.org/MPL/2.0/. + + +### "FOG", "Glean", and "Glean SDK" should remain in English. + +-fog-brand-name = FOG +-glean-brand-name = Glean +glean-sdk-brand-name = { -glean-brand-name } SDK +glean-debug-ping-viewer-brand-name = { -glean-brand-name } Debug Ping Viewer +about-glean-page-title2 = About { -glean-brand-name } +about-glean-header = About { -glean-brand-name } +about-glean-interface-description = + The <a data-l10n-name="glean-sdk-doc-link">{ glean-sdk-brand-name }</a> + is a data collection library used in { -vendor-short-name } projects. + This interface is designed to be used by developers and testers to manually + <a data-l10n-name="fog-link">test instrumentation</a>. +about-glean-upload-enabled = Data upload is enabled. +about-glean-upload-disabled = Data upload is disabled. +about-glean-upload-enabled-local = Data upload is enabled only for sending to a local server. +about-glean-upload-fake-enabled = + Data upload is disabled, + but we’re lying and telling the { glean-sdk-brand-name } it is enabled + so that data is still recorded locally. + Note: If you set a debug tag, pings will be uploaded to the + <a data-l10n-name="glean-debug-ping-viewer">{ glean-debug-ping-viewer-brand-name }</a> regardless of settings. +# This message is followed by a bulleted list. +about-glean-prefs-and-defines = Relevant <a data-l10n-name="fog-prefs-and-defines-doc-link">preferences and defines</a> include: +# Variables: +# $data-upload-pref-value (String): the value of the datareporting.healthreport.uploadEnabled pref. Typically "true", sometimes "false" +# Do not translate strings between <code> </code> tags. +about-glean-data-upload = <code>datareporting.healthreport.uploadEnabled</code>: { $data-upload-pref-value } +# Variables: +# $local-port-pref-value (Integer): the value of the telemetry.fog.test.localhost_port pref. Typically 0. Can be negative. +# Do not translate strings between <code> </code> tags. +about-glean-local-port = <code>telemetry.fog.test.localhost_port</code>: { $local-port-pref-value } +# Variables: +# $glean-android-define-value (Boolean): the value of the MOZ_GLEAN_ANDROID define. Typically "false", sometimes "true". +# Do not translate strings between <code> </code> tags. +about-glean-glean-android = <code>MOZ_GLEAN_ANDROID</code>: { $glean-android-define-value } +# Variables: +# $moz-official-define-value (Boolean): the value of the MOZILLA_OFFICIAL define. +# Do not translate strings between <code> </code> tags. +about-glean-moz-official = <code>MOZILLA_OFFICIAL</code>: { $moz-official-define-value } +about-glean-about-testing-header = About Testing +# This message is followed by a numbered list. +about-glean-manual-testing = + Full instructions are documented in the + <a data-l10n-name="fog-instrumentation-test-doc-link">{ -fog-brand-name } instrumentation testing docs</a> + and in the <a data-l10n-name="glean-sdk-doc-link">{ glean-sdk-brand-name } documentation</a>, + but, in short, to manually test that your instrumentation works, you should: +# This message is an option in a dropdown filled with untranslated names of pings. +about-glean-no-ping-label = (don’t submit any ping) +# An in-line text input field precedes this string. +about-glean-label-for-tag-pings = In the preceding field ensure there is a memorable debug tag so you can recognise your pings later. +# An in-line text input field precedes this string. +about-glean-label-for-tag-pings-with-requirements = Set a memorable debug tag <span>(20 characters or fewer, alphanumerics and - only)</span> so you can recognise your pings later. +# An in-line drop down list precedes this string. +# Do not translate strings between <code> </code> tags. +about-glean-label-for-ping-names = + Select from the preceding list the ping your instrumentation is in. + If it’s in a <a data-l10n-name="custom-ping-link">custom ping</a>, choose that one. + Otherwise, the default for <code>event</code> metrics is + the <code>events</code> ping + and the default for all other metrics is + the <code>metrics</code> ping. +# An in-line check box precedes this string. +about-glean-label-for-log-pings = + (Optional. Check the preceding box if you want pings to also be logged when they are submitted. + You will additionally need to <a data-l10n-name="enable-logging-link">enable logging</a>.) +# Variables +# $debug-tag (String): The user-set value of the debug tag input on this page. Like "about-glean-kV" +# An in-line button labeled "Apply settings and submit ping" precedes this string. +about-glean-label-for-controls-submit = + Press the preceding button to tag all { -glean-brand-name } pings with your tag and submit the selected ping. + (All pings submitted from then until you restart the application will be tagged with + <code>{ $debug-tag }</code>.) +about-glean-li-for-visit-gdpv = + <a data-l10n-name="gdpv-tagged-pings-link">Visit the { glean-debug-ping-viewer-brand-name } page for pings with your tag</a>. + It shouldn’t take more than a few seconds from pushing the button to your ping arriving. + Sometimes it may take a small handful of minutes. +# Do not translate strings between <code> </code> tags. +about-glean-adhoc-explanation = + For more <i>ad hoc</i> testing, + you can also determine the current value of a particular piece of instrumentation + by opening a devtools console here on <code>about:glean</code> + and using the <code>testGetValue()</code> API like + <code>Glean.metricCategory.metricName.testGetValue()</code>. +# Do not translate strings between <code> </code> tags. +about-glean-adhoc-explanation2 = + For more <i>ad hoc</i> testing, + you can also determine the current value of a particular piece of instrumentation + by opening a devtools console here on <code>about:glean</code> + and using the <code>testGetValue()</code> API like + <code>Glean.metricCategory.metricName.testGetValue()</code> + for a metric named <code>metric.category.metric_name</code>. +# Do not translate strings between <code> </code> tags. +about-glean-adhoc-note = + Please note that you are using the Glean JS API by using the devtools console. + This means the metric category and metric name are formatted in + <code>camelCase</code> unlike in the Rust and C++ APIs. +controls-button-label-verbose = Apply settings and submit ping +about-glean-about-data-header = About Data +about-glean-about-data-explanation = + To browse the list of collected data, please consult the + <a data-l10n-name="glean-dictionary-link">{ -glean-brand-name } Dictionary</a>. |