Add documentation link for few benchmarks

This CL also updates tools/perf/core_data_generator so that it generates the documentation links in the benchmark.csv file

Bug: chromium:859524
Cq-Include-Trybots: master.tryserver.chromium.perf:obbs_fyi
Change-Id: I99c77a9c2bd60ffdab1f8a628a208b2c81aa4ead
Reviewed-on: https://chromium-review.googlesource.com/1133199
Commit-Queue: Ned Nguyen <nednguyen@google.com>
Reviewed-by: Annie Sullivan <sullivan@chromium.org>
Cr-Commit-Position: refs/heads/master@{#574273}

tools/perf/benchmark.csv

 AUTOGENERATED FILE DO NOT EDIT
 See //tools/perf/generate_perf_data.py to make changes
-Benchmark name,Individual owners,Component
-angle_perftests,"jmadill@chromium.org, chrome-gpu-perf-owners@chromium.org",Internals>GPU>ANGLE
-blink_perf.bindings,"jbroman@chromium.org, yukishiino@chromium.org, haraken@chromium.org",
-blink_perf.canvas,junov@chromium.org,
-blink_perf.css,futhark@chromium.org,
-blink_perf.dom,"jbroman@chromium.org, yukishiino@chromium.org, haraken@chromium.org",
-blink_perf.events,hayato@chromium.org,
-blink_perf.image_decoder,cblume@chromium.org,
-blink_perf.layout,eae@chromium.org,
-blink_perf.owp_storage,dmurph@chromium.org,
-blink_perf.paint,wangxianzhu@chromium.org,
-blink_perf.parser,"jbroman@chromium.org, yukishiino@chromium.org, haraken@chromium.org",
-blink_perf.shadow_dom,hayato@chromium.org,
-blink_perf.svg,"kouhei@chromium.org, fs@opera.com",
-components_perftests,csharrison@chromium.org,
-dromaeo,"jbroman@chromium.org, yukishiino@chromium.org, haraken@chromium.org",
-dummy_benchmark.histogram_benchmark_1,"eakuefner@chromium.org, simonhatch@chromium.org",
-dummy_benchmark.noisy_benchmark_1,nednguyen@google.com,
-dummy_benchmark.stable_benchmark_1,nednguyen@google.com,
-gpu_perftests,"reveman@chromium.org, chrome-gpu-perf-owners@chromium.org",Internals>GPU
-jetstream,hablich@chromium.org,
-kraken,hablich@chromium.org,
-load_library_perf_tests,"xhwang@chromium.org, crouleau@chromium.org",Internals>Media>Encrypted
-loading.desktop,"kouhei@chromium.org, ksakamoto@chromium.org",
-loading.mobile,"kouhei@chromium.org, ksakamoto@chromium.org",
-media.desktop,"johnchen@chromium.org, crouleau@chromium.org",Internals>Media
-media.mobile,"johnchen@chromium.org, crouleau@chromium.org",Internals>Media
-media_perftests,crouleau@chromium.org,
-memory.desktop,erikchen@chromium.org,
-memory.long_running_idle_gmail_background_tbmv2,ulan@chromium.org,
-memory.long_running_idle_gmail_tbmv2,ulan@chromium.org,
-memory.top_10_mobile,perezju@chromium.org,
-net_perftests,xunjieli@chromium.org,
-octane,hablich@chromium.org,
-oortonline_tbmv2,ulan@chromium.org,
-passthrough_command_buffer_perftests,"piman@chromium.org, chrome-gpu-perf-owners@chromium.org",Internals>GPU>ANGLE
-performance_browser_tests,miu@chromium.org,
-power.desktop,charliea@chromium.org,
-power.typical_10_mobile,perezju@chromium.org,
-rasterize_and_record_micro.partial_invalidation,"vmpstr@chromium.org, wkorman@chromium.org",Internals>Compositing>Rasterization
-rasterize_and_record_micro.top_25,"vmpstr@chromium.org, wkorman@chromium.org",Internals>Compositing>Rasterization
-rendering.desktop,"sadrul@chromium.org, vmiura@chromium.org",
-rendering.mobile,"sadrul@chromium.org, vmiura@chromium.org",
-resource_sizes,"agrieve@chromium.org, rnephew@chromium.org, perezju@chromium.org",
-sizes (linux),thestig@chromium.org,
-sizes (mac),tapted@chromium.org,
-sizes (win),grt@chromium.org,
-smoothness.gpu_rasterization.tough_pinch_zoom_cases,ericrk@chromium.org,
-smoothness.tough_pinch_zoom_cases,bokan@chromium.org,
-speedometer,hablich@chromium.org,
-speedometer-future,hablich@chromium.org,
-speedometer2,hablich@chromium.org,
-speedometer2-future,hablich@chromium.org,
-start_with_url.cold.startup_pages,"pasko@chromium.org, chrome-android-perf-status@chromium.org",
-start_with_url.warm.startup_pages,"pasko@chromium.org, chrome-android-perf-status@chromium.org",
-supersize_archive,agrieve@chromium.org,
-system_health.common_desktop,"charliea@chromium.org, sullivan@chromium.org, tdresser@chromium.org",
-system_health.common_mobile,"charliea@chromium.org, sullivan@chromium.org, tdresser@chromium.org, perezju@chromium.org",
-system_health.memory_desktop,perezju@chromium.org,
-system_health.memory_mobile,perezju@chromium.org,
-system_health.webview_startup,"perezju@chromium.org, torne@chromium.org, changwan@chromium.org",Mobile>WebView>Perf
-tab_switching.typical_25,vovoy@chromium.org,OS>Performance
-tracing.tracing_with_background_memory_infra,ssid@chromium.org,
-tracing_perftests,"kkraynov@chromium.org, primiano@chromium.org",
-v8.browsing_desktop,"mythria@chromium.org, ulan@chromium.org",
-v8.browsing_desktop-future,"mythria@chromium.org, ulan@chromium.org",
-v8.browsing_mobile,"mythria@chromium.org, ulan@chromium.org",
-v8.browsing_mobile-future,"mythria@chromium.org, ulan@chromium.org",
-v8.runtime_stats.top_25,cbruni@chromium.org,
-validating_command_buffer_perftests,"piman@chromium.org, chrome-gpu-perf-owners@chromium.org",Internals>GPU
-views_perftests,tapted@chromium.org,Internals>Views
-wasm,bradnelson@chromium.org,
-webrtc,"qiangchen@chromium.org, ehmaldonado@chromium.org, phoglund@chromium.org",
+Benchmark name,Individual owners,Component,Documentation
+angle_perftests,"jmadill@chromium.org, chrome-gpu-perf-owners@chromium.org",Internals>GPU>ANGLE,
+blink_perf.bindings,"jbroman@chromium.org, yukishiino@chromium.org, haraken@chromium.org",,https://bit.ly/blink-perf-benchmarks
+blink_perf.canvas,junov@chromium.org,,https://bit.ly/blink-perf-benchmarks
+blink_perf.css,futhark@chromium.org,,https://bit.ly/blink-perf-benchmarks
+blink_perf.dom,"jbroman@chromium.org, yukishiino@chromium.org, haraken@chromium.org",,https://bit.ly/blink-perf-benchmarks
+blink_perf.events,hayato@chromium.org,,https://bit.ly/blink-perf-benchmarks
+blink_perf.image_decoder,cblume@chromium.org,,https://bit.ly/blink-perf-benchmarks
+blink_perf.layout,eae@chromium.org,,https://bit.ly/blink-perf-benchmarks
+blink_perf.owp_storage,dmurph@chromium.org,,https://bit.ly/blink-perf-benchmarks
+blink_perf.paint,wangxianzhu@chromium.org,,https://bit.ly/blink-perf-benchmarks
+blink_perf.parser,"jbroman@chromium.org, yukishiino@chromium.org, haraken@chromium.org",,https://bit.ly/blink-perf-benchmarks
+blink_perf.shadow_dom,hayato@chromium.org,,https://bit.ly/blink-perf-benchmarks
+blink_perf.svg,"kouhei@chromium.org, fs@opera.com",,https://bit.ly/blink-perf-benchmarks
+components_perftests,csharrison@chromium.org,,
+dromaeo,"jbroman@chromium.org, yukishiino@chromium.org, haraken@chromium.org",,
+dummy_benchmark.histogram_benchmark_1,"eakuefner@chromium.org, simonhatch@chromium.org",,
+dummy_benchmark.noisy_benchmark_1,nednguyen@google.com,,
+dummy_benchmark.stable_benchmark_1,nednguyen@google.com,,
+gpu_perftests,"reveman@chromium.org, chrome-gpu-perf-owners@chromium.org",Internals>GPU,
+jetstream,hablich@chromium.org,,
+kraken,hablich@chromium.org,,
+load_library_perf_tests,"xhwang@chromium.org, crouleau@chromium.org",Internals>Media>Encrypted,
+loading.desktop,"kouhei@chromium.org, ksakamoto@chromium.org",,https://bit.ly/loading-benchmarks
+loading.mobile,"kouhei@chromium.org, ksakamoto@chromium.org",,https://bit.ly/loading-benchmarks
+media.desktop,"johnchen@chromium.org, crouleau@chromium.org",Internals>Media,
+media.mobile,"johnchen@chromium.org, crouleau@chromium.org",Internals>Media,
+media_perftests,crouleau@chromium.org,,
+memory.desktop,erikchen@chromium.org,,
+memory.long_running_idle_gmail_background_tbmv2,ulan@chromium.org,,
+memory.long_running_idle_gmail_tbmv2,ulan@chromium.org,,
+memory.top_10_mobile,perezju@chromium.org,,
+net_perftests,xunjieli@chromium.org,,
+octane,hablich@chromium.org,,
+oortonline_tbmv2,ulan@chromium.org,,
+passthrough_command_buffer_perftests,"piman@chromium.org, chrome-gpu-perf-owners@chromium.org",Internals>GPU>ANGLE,
+performance_browser_tests,miu@chromium.org,,
+power.desktop,charliea@chromium.org,,https://bit.ly/power-benchmarks
+power.typical_10_mobile,perezju@chromium.org,,https://bit.ly/power-benchmarks
+rasterize_and_record_micro.partial_invalidation,"vmpstr@chromium.org, wkorman@chromium.org",Internals>Compositing>Rasterization,
+rasterize_and_record_micro.top_25,"vmpstr@chromium.org, wkorman@chromium.org",Internals>Compositing>Rasterization,
+rendering.desktop,"sadrul@chromium.org, vmiura@chromium.org",,https://bit.ly/rendering-benchmarks
+rendering.mobile,"sadrul@chromium.org, vmiura@chromium.org",,https://bit.ly/rendering-benchmarks
+resource_sizes,"agrieve@chromium.org, rnephew@chromium.org, perezju@chromium.org",,
+sizes (linux),thestig@chromium.org,,
+sizes (mac),tapted@chromium.org,,
+sizes (win),grt@chromium.org,,
+smoothness.gpu_rasterization.tough_pinch_zoom_cases,ericrk@chromium.org,,
+smoothness.tough_pinch_zoom_cases,bokan@chromium.org,,
+speedometer,hablich@chromium.org,,
+speedometer-future,hablich@chromium.org,,
+speedometer2,hablich@chromium.org,,
+speedometer2-future,hablich@chromium.org,,
+start_with_url.cold.startup_pages,"pasko@chromium.org, chrome-android-perf-status@chromium.org",,
+start_with_url.warm.startup_pages,"pasko@chromium.org, chrome-android-perf-status@chromium.org",,
+supersize_archive,agrieve@chromium.org,,
+system_health.common_desktop,"charliea@chromium.org, sullivan@chromium.org, tdresser@chromium.org",,https://bit.ly/system-health-benchmarks
+system_health.common_mobile,"charliea@chromium.org, sullivan@chromium.org, tdresser@chromium.org, perezju@chromium.org",,https://bit.ly/system-health-benchmarks
+system_health.memory_desktop,perezju@chromium.org,,https://bit.ly/system-health-benchmarks
+system_health.memory_mobile,perezju@chromium.org,,https://bit.ly/system-health-benchmarks
+system_health.webview_startup,"perezju@chromium.org, torne@chromium.org, changwan@chromium.org",Mobile>WebView>Perf,
+tab_switching.typical_25,vovoy@chromium.org,OS>Performance,
+tracing.tracing_with_background_memory_infra,ssid@chromium.org,,
+tracing_perftests,"kkraynov@chromium.org, primiano@chromium.org",,
+v8.browsing_desktop,"mythria@chromium.org, ulan@chromium.org",,
+v8.browsing_desktop-future,"mythria@chromium.org, ulan@chromium.org",,
+v8.browsing_mobile,"mythria@chromium.org, ulan@chromium.org",,
+v8.browsing_mobile-future,"mythria@chromium.org, ulan@chromium.org",,
+v8.runtime_stats.top_25,cbruni@chromium.org,,
+validating_command_buffer_perftests,"piman@chromium.org, chrome-gpu-perf-owners@chromium.org",Internals>GPU,
+views_perftests,tapted@chromium.org,Internals>Views,
+wasm,bradnelson@chromium.org,,
+webrtc,"qiangchen@chromium.org, ehmaldonado@chromium.org, phoglund@chromium.org",,http://bit.ly/webrtc-benchmark

tools/perf/benchmarks/blink_perf.py

@@ -353,9 +353,10 @@ class _BlinkPerfBenchmark(perf_benchmark.PerfBenchmark):
     return CreateStorySetFromPath(path, SKIPPED_FILE)
 
 
-@benchmark.Info(emails=['jbroman@chromium.org',
-                         'yukishiino@chromium.org',
-                         'haraken@chromium.org'])
+@benchmark.Info(
+    emails=['jbroman@chromium.org', 'yukishiino@chromium.org',
+            'haraken@chromium.org'],
+    documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfBindings(_BlinkPerfBenchmark):
   subdir = 'bindings'
 
@@ -364,7 +365,8 @@ class BlinkPerfBindings(_BlinkPerfBenchmark):
     return 'blink_perf.bindings'
 
 
-@benchmark.Info(emails=['futhark@chromium.org'])
+@benchmark.Info(emails=['futhark@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfCSS(_BlinkPerfBenchmark):
   subdir = 'css'
 
@@ -374,7 +376,8 @@ class BlinkPerfCSS(_BlinkPerfBenchmark):
 
 
 
-@benchmark.Info(emails=['junov@chromium.org'])
+@benchmark.Info(emails=['junov@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfCanvas(_BlinkPerfBenchmark):
   subdir = 'canvas'
 
@@ -397,7 +400,8 @@ class BlinkPerfCanvas(_BlinkPerfBenchmark):
 
 @benchmark.Info(emails=['jbroman@chromium.org',
                          'yukishiino@chromium.org',
-                         'haraken@chromium.org'])
+                         'haraken@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfDOM(_BlinkPerfBenchmark):
   subdir = 'dom'
 
@@ -406,7 +410,8 @@ class BlinkPerfDOM(_BlinkPerfBenchmark):
     return 'blink_perf.dom'
 
 
-@benchmark.Info(emails=['hayato@chromium.org'])
+@benchmark.Info(emails=['hayato@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfEvents(_BlinkPerfBenchmark):
   subdir = 'events'
 
@@ -415,7 +420,8 @@ class BlinkPerfEvents(_BlinkPerfBenchmark):
     return 'blink_perf.events'
 
 
-@benchmark.Info(emails=['cblume@chromium.org'])
+@benchmark.Info(emails=['cblume@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfImageDecoder(_BlinkPerfBenchmark):
   tag = 'image_decoder'
   subdir = 'image_decoder'
@@ -430,7 +436,8 @@ class BlinkPerfImageDecoder(_BlinkPerfBenchmark):
     ])
 
 
-@benchmark.Info(emails=['eae@chromium.org'])
+@benchmark.Info(emails=['eae@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfLayout(_BlinkPerfBenchmark):
   subdir = 'layout'
 
@@ -439,7 +446,8 @@ class BlinkPerfLayout(_BlinkPerfBenchmark):
     return 'blink_perf.layout'
 
 
-@benchmark.Info(emails=['dmurph@chromium.org'])
+@benchmark.Info(emails=['dmurph@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfOWPStorage(_BlinkPerfBenchmark):
   subdir = 'owp_storage'
 
@@ -457,7 +465,8 @@ class BlinkPerfOWPStorage(_BlinkPerfBenchmark):
     ])
 
 
-@benchmark.Info(emails=['wangxianzhu@chromium.org'])
+@benchmark.Info(emails=['wangxianzhu@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfPaint(_BlinkPerfBenchmark):
   subdir = 'paint'
 
@@ -468,7 +477,8 @@ class BlinkPerfPaint(_BlinkPerfBenchmark):
 
 @benchmark.Info(emails=['jbroman@chromium.org',
                          'yukishiino@chromium.org',
-                         'haraken@chromium.org'])
+                         'haraken@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfParser(_BlinkPerfBenchmark):
   subdir = 'parser'
 
@@ -477,7 +487,8 @@ class BlinkPerfParser(_BlinkPerfBenchmark):
     return 'blink_perf.parser'
 
 
-@benchmark.Info(emails=['kouhei@chromium.org', 'fs@opera.com'])
+@benchmark.Info(emails=['kouhei@chromium.org', 'fs@opera.com'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfSVG(_BlinkPerfBenchmark):
   subdir = 'svg'
 
@@ -486,7 +497,8 @@ class BlinkPerfSVG(_BlinkPerfBenchmark):
     return 'blink_perf.svg'
 
 
-@benchmark.Info(emails=['hayato@chromium.org'])
+@benchmark.Info(emails=['hayato@chromium.org'],
+                documentation_url='https://bit.ly/blink-perf-benchmarks')
 class BlinkPerfShadowDOM(_BlinkPerfBenchmark):
   subdir = 'shadow_dom'
 

tools/perf/benchmarks/loading.py

@@ -24,7 +24,8 @@ class _LoadingBase(perf_benchmark.PerfBenchmark):
     return tbm_options
 
 
-@benchmark.Info(emails=['kouhei@chromium.org', 'ksakamoto@chromium.org'])
+@benchmark.Info(emails=['kouhei@chromium.org', 'ksakamoto@chromium.org'],
+                documentation_url='https://bit.ly/loading-benchmarks')
 class LoadingDesktop(_LoadingBase):
   """ A benchmark measuring loading performance of desktop sites. """
   SUPPORTED_PLATFORMS = [story.expectations.ALL_DESKTOP]
@@ -38,7 +39,8 @@ class LoadingDesktop(_LoadingBase):
     return 'loading.desktop'
 
 
-@benchmark.Info(emails=['kouhei@chromium.org', 'ksakamoto@chromium.org'])
+@benchmark.Info(emails=['kouhei@chromium.org', 'ksakamoto@chromium.org'],
+                documentation_url='https://bit.ly/loading-benchmarks')
 class LoadingMobile(_LoadingBase):
   """ A benchmark measuring loading performance of mobile sites. """
   SUPPORTED_PLATFORMS = [story.expectations.ALL_MOBILE]

tools/perf/benchmarks/power.py

@@ -12,7 +12,8 @@ from telemetry.timeline import chrome_trace_category_filter
 from telemetry.web_perf import timeline_based_measurement
 
 
-@benchmark.Info(emails=['perezju@chromium.org'])
+@benchmark.Info(emails=['perezju@chromium.org'],
+                documentation_url='https://bit.ly/power-benchmarks')
 class PowerTypical10Mobile(perf_benchmark.PerfBenchmark):
   """Android typical 10 mobile power test."""
   test = power.Power
@@ -27,7 +28,8 @@ class PowerTypical10Mobile(perf_benchmark.PerfBenchmark):
     return 'power.typical_10_mobile'
 
 
-@benchmark.Info(emails=['charliea@chromium.org'])
+@benchmark.Info(emails=['charliea@chromium.org'],
+                documentation_url='https://bit.ly/power-benchmarks')
 class PowerDesktop(perf_benchmark.PerfBenchmark):
   SUPPORTED_PLATFORMS = [story.expectations.ALL_DESKTOP]
 

tools/perf/benchmarks/rendering.py

@@ -9,7 +9,8 @@ from telemetry import benchmark
 from telemetry import story as story_module
 
 
-@benchmark.Info(emails=['sadrul@chromium.org', 'vmiura@chromium.org'])
+@benchmark.Info(emails=['sadrul@chromium.org', 'vmiura@chromium.org'],
+                documentation_url='https://bit.ly/rendering-benchmarks')
 class RenderingDesktop(perf_benchmark.PerfBenchmark):
 
   test = rendering.Rendering
@@ -30,7 +31,8 @@ class RenderingDesktop(perf_benchmark.PerfBenchmark):
     return page_sets.RenderingStorySet(platform='desktop')
 
 
-@benchmark.Info(emails=['sadrul@chromium.org', 'vmiura@chromium.org'])
+@benchmark.Info(emails=['sadrul@chromium.org', 'vmiura@chromium.org'],
+                documentation_url='https://bit.ly/rendering-benchmarks')
 class RenderingMobile(perf_benchmark.PerfBenchmark):
 
   test = rendering.Rendering

tools/perf/benchmarks/system_health.py

@@ -59,7 +59,8 @@ class _CommonSystemHealthBenchmark(perf_benchmark.PerfBenchmark):
 
 
 @benchmark.Info(emails=['charliea@chromium.org', 'sullivan@chromium.org',
-                        'tdresser@chromium.org'])
+                        'tdresser@chromium.org'],
+                documentation_url='https://bit.ly/system-health-benchmarks')
 class DesktopCommonSystemHealth(_CommonSystemHealthBenchmark):
   """Desktop Chrome Energy System Health Benchmark."""
   PLATFORM = 'desktop'
@@ -71,7 +72,9 @@ class DesktopCommonSystemHealth(_CommonSystemHealthBenchmark):
 
 
 @benchmark.Info(emails=['charliea@chromium.org', 'sullivan@chromium.org',
-                        'tdresser@chromium.org', 'perezju@chromium.org'])
+                        'tdresser@chromium.org', 'perezju@chromium.org'],
+
+                documentation_url='https://bit.ly/system-health-benchmarks')
 class MobileCommonSystemHealth(_CommonSystemHealthBenchmark):
   """Mobile Chrome Energy System Health Benchmark."""
   PLATFORM = 'mobile'
@@ -115,7 +118,8 @@ class _MemorySystemHealthBenchmark(perf_benchmark.PerfBenchmark):
     return not _IGNORED_STATS_RE.search(name)
 
 
-@benchmark.Info(emails=['perezju@chromium.org'])
+@benchmark.Info(emails=['perezju@chromium.org'],
+                documentation_url='https://bit.ly/system-health-benchmarks')
 class DesktopMemorySystemHealth(_MemorySystemHealthBenchmark):
   """Desktop Chrome Memory System Health Benchmark."""
   PLATFORM = 'desktop'
@@ -126,7 +130,8 @@ class DesktopMemorySystemHealth(_MemorySystemHealthBenchmark):
     return 'system_health.memory_desktop'
 
 
-@benchmark.Info(emails=['perezju@chromium.org'])
+@benchmark.Info(emails=['perezju@chromium.org'],
+                documentation_url='https://bit.ly/system-health-benchmarks')
 class MobileMemorySystemHealth(_MemorySystemHealthBenchmark):
   """Mobile Chrome Memory System Health Benchmark."""
   PLATFORM = 'mobile'

tools/perf/benchmarks/webrtc.py

@@ -12,7 +12,8 @@ from telemetry.web_perf import timeline_based_measurement
 
 @benchmark.Info(emails=['qiangchen@chromium.org', # For smoothness metrics
                          'ehmaldonado@chromium.org',
-                         'phoglund@chromium.org'])
+                         'phoglund@chromium.org'],
+                documentation_url='http://bit.ly/webrtc-benchmark')
 class WebrtcPerfBenchmark(perf_benchmark.PerfBenchmark):
   """Base class for WebRTC metrics for real-time communications tests."""
   page_set = page_sets.WebrtcPageSet

tools/perf/core/perf_data_generator.py

@@ -476,45 +476,49 @@ def update_all_tests(waterfall, file_path):
 # waterfalls. Right now, all the below benchmarks are scheduled, but some other
 # benchmarks are not scheduled, because they're disabled on all platforms.
 BenchmarkMetadata = collections.namedtuple(
-    'BenchmarkMetadata', 'emails component not_scheduled')
+    'BenchmarkMetadata', 'emails component documentation_url not_scheduled')
 NON_TELEMETRY_BENCHMARKS = {
     'angle_perftests': BenchmarkMetadata(
         'jmadill@chromium.org, chrome-gpu-perf-owners@chromium.org',
-        'Internals>GPU>ANGLE', False),
+        'Internals>GPU>ANGLE', None, False),
     'validating_command_buffer_perftests': BenchmarkMetadata(
         'piman@chromium.org, chrome-gpu-perf-owners@chromium.org',
-        'Internals>GPU', False),
+        'Internals>GPU', None, False),
     'passthrough_command_buffer_perftests': BenchmarkMetadata(
         'piman@chromium.org, chrome-gpu-perf-owners@chromium.org',
-        'Internals>GPU>ANGLE', False),
-    'net_perftests': BenchmarkMetadata('xunjieli@chromium.org', None, False),
+        'Internals>GPU>ANGLE', None, False),
+    'net_perftests': BenchmarkMetadata(
+        'xunjieli@chromium.org', None, None, False),
     'gpu_perftests': BenchmarkMetadata(
         'reveman@chromium.org, chrome-gpu-perf-owners@chromium.org',
-        'Internals>GPU', False),
+        'Internals>GPU', None, False),
     'tracing_perftests': BenchmarkMetadata(
-        'kkraynov@chromium.org, primiano@chromium.org', None, False),
+        'kkraynov@chromium.org, primiano@chromium.org', None, None, False),
     'load_library_perf_tests': BenchmarkMetadata(
         'xhwang@chromium.org, crouleau@chromium.org',
-        'Internals>Media>Encrypted', False),
-    'media_perftests': BenchmarkMetadata('crouleau@chromium.org', None, False),
+        'Internals>Media>Encrypted', None, False),
+    'media_perftests': BenchmarkMetadata(
+        'crouleau@chromium.org', None, None, False),
     'performance_browser_tests': BenchmarkMetadata(
-        'miu@chromium.org', None, False),
+        'miu@chromium.org', None, None, False),
     'views_perftests': BenchmarkMetadata(
-        'tapted@chromium.org', 'Internals>Views', False),
+        'tapted@chromium.org', 'Internals>Views', None, False),
     'components_perftests': BenchmarkMetadata(
-        'csharrison@chromium.org', None, False)
+        'csharrison@chromium.org', None, None, False)
 }
 
 
 # If you change this dictionary, run tools/perf/generate_perf_data
 NON_WATERFALL_BENCHMARKS = {
-    'sizes (mac)': BenchmarkMetadata('tapted@chromium.org', None, False),
-    'sizes (win)': BenchmarkMetadata('grt@chromium.org', None, False),
-    'sizes (linux)': BenchmarkMetadata('thestig@chromium.org', None, False),
+    'sizes (mac)': BenchmarkMetadata('tapted@chromium.org', None, None, False),
+    'sizes (win)': BenchmarkMetadata('grt@chromium.org', None, None, False),
+    'sizes (linux)': BenchmarkMetadata(
+        'thestig@chromium.org', None, None, False),
     'resource_sizes': BenchmarkMetadata(
         'agrieve@chromium.org, rnephew@chromium.org, perezju@chromium.org',
-        None, False),
-    'supersize_archive': BenchmarkMetadata('agrieve@chromium.org', None, False),
+        None, None, False),
+    'supersize_archive': BenchmarkMetadata(
+        'agrieve@chromium.org', None, None, False),
 }
 
 
@@ -532,7 +536,8 @@ def get_all_benchmarks_metadata(metadata):
     if emails:
       emails = ', '.join(emails)
     metadata[benchmark.Name()] = BenchmarkMetadata(
-        emails, decorators.GetComponent(benchmark), False)
+        emails, decorators.GetComponent(benchmark),
+        decorators.GetDocumentationLink(benchmark), False)
   return metadata
 
 # With migration to new recipe tests are now listed in the shard maps
@@ -618,7 +623,7 @@ def update_benchmark_csv(file_path):
   """
   header_data = [['AUTOGENERATED FILE DO NOT EDIT'],
       ['See //tools/perf/generate_perf_data.py to make changes'],
-      ['Benchmark name', 'Individual owners', 'Component']
+      ['Benchmark name', 'Individual owners', 'Component', 'Documentation']
   ]
 
   csv_data = []
@@ -631,7 +636,8 @@ def update_benchmark_csv(file_path):
     csv_data.append([
         benchmark_name,
         benchmark_metadata[benchmark_name].emails,
-        benchmark_metadata[benchmark_name].component
+        benchmark_metadata[benchmark_name].component,
+        benchmark_metadata[benchmark_name].documentation_url,
     ])
 
   csv_data = sorted(csv_data, key=lambda b: b[0])

tools/perf/core/perf_data_generator_unittest.py

@@ -35,9 +35,11 @@ class PerfDataGeneratorTest(unittest.TestCase):
         }
     }
     benchmarks = {
-        'benchmark_name_1': BenchmarkMetadata('foo@bar.com', None, False),
-        'benchmark_name_2': BenchmarkMetadata('darth@deathstar', None, False),
-        'benchmark_name_3': BenchmarkMetadata('neo@matrix.org', None, False)
+        'benchmark_name_1': BenchmarkMetadata('foo@bar.com', None, None, False),
+        'benchmark_name_2':
+            BenchmarkMetadata('darth@deathstar', None, None, False),
+        'benchmark_name_3':
+            BenchmarkMetadata('neo@matrix.org', None, None, False)
     }
 
     # Mock out content of unowned_benchmarks.txt and sharding map
@@ -63,8 +65,8 @@ class PerfDataGeneratorTest(unittest.TestCase):
         }
     }
     benchmarks = {
-        'benchmark_name_2': BenchmarkMetadata(None, None, False),
-        'benchmark_name_3': BenchmarkMetadata(None, None, False),
+        'benchmark_name_2': BenchmarkMetadata(None, None, None, False),
+        'benchmark_name_3': BenchmarkMetadata(None, None, None, False),
     }
 
     with self.assertRaises(AssertionError) as context:
@@ -77,7 +79,7 @@ class PerfDataGeneratorTest(unittest.TestCase):
   def testVerifyAllTestsInBenchmarkCsvFindsFakeTest(self):
     tests = {'Random fake test': {}}
     benchmarks = {
-        'benchmark_name_1': BenchmarkMetadata(None, None, False)
+        'benchmark_name_1': BenchmarkMetadata(None, None, None, False)
     }
 
     with self.assertRaises(AssertionError) as context: