Bug 1682898 Migrate Performance Best Practices for Front-end Engineers MDN...

Bug 1682898 Migrate Performance Best Practices for Front-end Engineers MDN page to in-tree docs r=firefox-source-docs-reviewers,bas,ahal

***
Bug 1682898 Migrate Performance Best Practices for Front-end Engineers MDN page to in-tree docs

***
Bug 1682898 Migrate Performance Best Practices for Front-end Engineers MDN page to in-tree docs

Differential Revision: https://phabricator.services.mozilla.com/D109970

browser/base/content/test/performance/browser_appmenu.js

@@ -12,7 +12,7 @@ let gCUITestUtils = new CustomizableUITestUtils(window);
  * away as we improve the performance of the front-end. Instead of adding more
  * reflows to the list, you should be modifying your code to avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_APPMENU_OPEN_REFLOWS = [

browser/base/content/test/performance/browser_tabclose.js

@@ -5,7 +5,7 @@
  * Instead of adding reflows to the list, you should be modifying your code to
  * avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_REFLOWS = [

browser/base/content/test/performance/browser_tabclose_grow.js

@@ -5,7 +5,7 @@
  * Instead of adding reflows to the list, you should be modifying your code to
  * avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_REFLOWS = [

browser/base/content/test/performance/browser_tabdetach.js

@@ -6,7 +6,7 @@
  * Instead of adding more reflows to the list, you should be modifying your code
  * to avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_REFLOWS = [

browser/base/content/test/performance/browser_tabopen.js

@@ -8,7 +8,7 @@
  * Instead of adding reflows to the list, you should be modifying your code to
  * avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_REFLOWS = [

browser/base/content/test/performance/browser_tabopen_squeeze.js

@@ -5,7 +5,7 @@
  * Instead of adding reflows to the list, you should be modifying your code to
  * avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_REFLOWS = [

browser/base/content/test/performance/browser_tabstrip_overflow_underflow.js

@@ -6,7 +6,7 @@
  * Instead of adding more reflows to the lists, you should be modifying your
  * code to avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_OVERFLOW_REFLOWS = [

browser/base/content/test/performance/browser_tabswitch.js

@@ -8,7 +8,7 @@
  * Instead of adding reflows to the list, you should be modifying your code to
  * avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See  https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_REFLOWS = [

browser/base/content/test/performance/browser_urlbar_keyed_search.js

@@ -8,7 +8,7 @@
  * Instead of adding reflows to these lists, you should be modifying your code
  * to avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 

browser/base/content/test/performance/browser_urlbar_search.js

@@ -8,7 +8,7 @@
  * Instead of adding reflows to these lists, you should be modifying your code
  * to avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 

browser/base/content/test/performance/browser_window_resize.js

@@ -8,7 +8,7 @@
  * Instead of adding reflows to the list, you should be modifying your code to
  * avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_REFLOWS = [

browser/base/content/test/performance/browser_windowclose.js

@@ -5,7 +5,7 @@
  * Instead of adding reflows to the list, you should be modifying your code to
  * avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_REFLOWS = [

browser/base/content/test/performance/browser_windowopen.js

@@ -8,7 +8,7 @@
  * Instead of adding reflows to the list, you should be modifying your code to
  * avoid the reflow.
  *
- * See https://developer.mozilla.org/en-US/Firefox/Performance_best_practices_for_Firefox_fe_engineers
+ * See https://firefox-source-docs.mozilla.org/performance/bestpractices.html
  * for tips on how to do that.
  */
 const EXPECTED_REFLOWS = [

docs/config.yml

@@ -28,6 +28,7 @@ categories:
         - code-quality
         - writing-rust-code
         - tools/profiler
+        - performance
         - xpcom
     build_doc:
         - mach

docs/performance/index.md

+# Performance
+
+This page explains how optimize the performance the Firefox code base
+
+The [test documentation](../../testing/perfdocs/)
+explains how to test for performance in Firefox. 
+The [profiler documentation](../../tools/profiler/)
+explains how to use the Gecko profiler. 
+
+```eval_rst
+.. toctree::
+    :titlesonly:
+    :maxdepth: 1
+    :glob:
+
+    *
+```

moz.build

@@ -195,4 +195,6 @@ SPHINX_TREES["setup"] = "docs/setup"
 
 SPHINX_TREES["crash-reporting"] = "docs/crash-reporting"
 
+SPHINX_TREES["performance"] = "docs/performance"
+
 include("build/templates.mozbuild")