chrome-devtools-frontend 1.0.1040857 → 1.0.1070764

package/AUTHORS

@@ -30,6 +30,7 @@ Feng Lu <lufengd3@gmail.com>
 Feng Yu <f3n67u@gmail.com>
 Gabriel Luong <gabriel.luong@gmail.com>
 Gautham Banasandra <gautham.bangalore@gmail.com>
+Han Xu <suyanhanx@gmail.com>
 Jacky Hu <flameddd@gmail.com>
 Jake Mulhern <mulherje@gmail.com>
 Jan Keitel <jan.keitel@gmail.com>
@@ -51,13 +52,15 @@ Rahat Muneeb <irahatmuneeb@gmail.com>
 Rahul B S <bsrahul2020@gmail.com>
 Rajasekar Murugan <rajasekar89be@gmail.com>
 Ross Wollman <ross.wollman@gmail.com>
+Serg Kryvonos <sergeikrivonos@gmail.com>
 Stephen Tsoi-A-Sue <stsoiasue@gmail.com>
 Tony Kostowny <tonykostowny@gmail.com>
 Toshiaki Tanaka <zokutyou2@gmail.com>
 Varun Varada <varuncvarada@gmail.com>
 Will Hernandez <w.hernandez.code@gmail.com>
 Yeol Park <peary2@gmail.com>
-Yisi <yiorsi@gmail.com>
+Yisi(一丝) <yiorsi@gmail.com>
+Yoichiro Hibara <hibarayoichiro871@gmail.com>
 Yuan Zhuang <joann.yuanzhuang@gmail.com>
 # Please DO NOT APPEND here. See comments at the top of the file.
 # END individuals section.

package/README.md

@@ -12,17 +12,11 @@ The client-side of the Chrome DevTools, including all JS & CSS to run the DevToo
 
 The frontend is available on [chromium.googlesource.com](https://chromium.googlesource.com/devtools/devtools-frontend).
 
-### Design guidelines
+### Project documentation
 
-Please be aware that DevTools follows additional [development guidelines](docs/design_guidelines.md).
-
-### Issue triage
-
-The issue triage guidelines can be found [in docs/triage_guidelines.md](docs/triage_guidelines.md).
-
-### Workflows
-
-Instructions to set up, use, and maintain a DevTools frontend checkout can be found [in docs/workflows.md](docs/workflows.md).
+Check out the [project documentation](https://chromium.googlesource.com/devtools/devtools-frontend/+/main/docs/README.md)
+for instructions to set up, use, and maintain a DevTools front-end checkout, as well as design guidelines, and architectural
+documentation.
 
 ### Additional references
 

package/config/gni/devtools_grd_files.gni

@@ -52,6 +52,7 @@ grd_files_release_sources = [
   "front_end/Images/copy_icon.svg",
   "front_end/Images/cssoverview_icons_2x.avif",
   "front_end/Images/dropdown_7x6_icon.svg",
+  "front_end/Images/edit-icon.svg",
   "front_end/Images/elements_panel_icon.svg",
   "front_end/Images/errorWave.svg",
   "front_end/Images/error_icon.svg",
@@ -61,6 +62,8 @@ grd_files_release_sources = [
   "front_end/Images/flex-direction-icon.svg",
   "front_end/Images/flex-nowrap-icon.svg",
   "front_end/Images/flex-wrap-icon.svg",
+  "front_end/Images/frame-embedded-icon.svg",
+  "front_end/Images/frame-icon.svg",
   "front_end/Images/help_outline.svg",
   "front_end/Images/ic_changes.svg",
   "front_end/Images/ic_checkmark_16x16.svg",
@@ -153,6 +156,7 @@ grd_files_release_sources = [
   "front_end/Images/touchCursor.png",
   "front_end/Images/touchCursor_2x.png",
   "front_end/Images/trash_bin_icon.svg",
+  "front_end/Images/trash_bin_material_icon.svg",
   "front_end/Images/treeoutlineTriangles.svg",
   "front_end/Images/triangle-collapsed.svg",
   "front_end/Images/triangle-expanded.svg",
@@ -286,6 +290,7 @@ grd_files_release_sources = [
   "front_end/models/issues_manager/descriptions/arInvalidRegisterSourceHeader.md",
   "front_end/models/issues_manager/descriptions/arInvalidRegisterTriggerHeader.md",
   "front_end/models/issues_manager/descriptions/arPermissionPolicyDisabled.md",
+  "front_end/models/issues_manager/descriptions/arPermissionPolicyNotDelegated.md",
   "front_end/models/issues_manager/descriptions/arSourceAndTriggerHeaders.md",
   "front_end/models/issues_manager/descriptions/arSourceIgnored.md",
   "front_end/models/issues_manager/descriptions/arTriggerIgnored.md",
@@ -393,8 +398,6 @@ grd_files_release_sources = [
   "front_end/panels/emulation/emulation-meta.js",
   "front_end/panels/emulation/emulation.js",
   "front_end/panels/event_listeners/event_listeners.js",
-  "front_end/panels/input/input-meta.js",
-  "front_end/panels/input/input.js",
   "front_end/panels/issues/components/components.js",
   "front_end/panels/issues/issues-meta.js",
   "front_end/panels/issues/issues.js",
@@ -461,7 +464,6 @@ grd_files_release_sources = [
   "front_end/panels/webauthn/webauthn.js",
   "front_end/services/puppeteer/puppeteer.js",
   "front_end/services/window_bounds/window_bounds.js",
-  "front_end/third_party/acorn-loose/acorn-loose.js",
   "front_end/third_party/acorn/acorn.js",
   "front_end/third_party/chromium/client-variations/client-variations.js",
   "front_end/third_party/codemirror.next/chunk/codemirror.js",
@@ -511,6 +513,7 @@ grd_files_release_sources = [
   "front_end/ui/components/text_editor/text_editor.js",
   "front_end/ui/components/text_prompt/text_prompt.js",
   "front_end/ui/components/tree_outline/tree_outline.js",
+  "front_end/ui/components/two_states_counter/two_states_counter.js",
   "front_end/ui/legacy/components/color_picker/color_picker-legacy.js",
   "front_end/ui/legacy/components/color_picker/color_picker.js",
   "front_end/ui/legacy/components/cookie_table/cookie_table-legacy.js",
@@ -677,11 +680,9 @@ grd_files_debug_sources = [
   "front_end/entrypoints/formatter_worker/FormattedContentBuilder.js",
   "front_end/entrypoints/formatter_worker/FormatterWorker.js",
   "front_end/entrypoints/formatter_worker/HTMLFormatter.js",
-  "front_end/entrypoints/formatter_worker/HTMLOutline.js",
   "front_end/entrypoints/formatter_worker/IdentityFormatter.js",
   "front_end/entrypoints/formatter_worker/JSONFormatter.js",
   "front_end/entrypoints/formatter_worker/JavaScriptFormatter.js",
-  "front_end/entrypoints/formatter_worker/JavaScriptOutline.js",
   "front_end/entrypoints/formatter_worker/ScopeParser.js",
   "front_end/entrypoints/formatter_worker/Substitute.js",
   "front_end/entrypoints/heap_snapshot_worker/AllocationProfile.js",
@@ -795,7 +796,6 @@ grd_files_debug_sources = [
   "front_end/models/text_utils/TextRange.js",
   "front_end/models/text_utils/TextUtils.js",
   "front_end/models/timeline_model/TimelineFrameModel.js",
-  "front_end/models/timeline_model/TimelineIRModel.js",
   "front_end/models/timeline_model/TimelineJSProfile.js",
   "front_end/models/timeline_model/TimelineModel.js",
   "front_end/models/timeline_model/TimelineModelFilter.js",
@@ -863,6 +863,8 @@ grd_files_debug_sources = [
   "front_end/panels/application/components/Prerender2.js",
   "front_end/panels/application/components/ProtocolHandlersView.js",
   "front_end/panels/application/components/ReportsGrid.js",
+  "front_end/panels/application/components/SharedStorageAccessGrid.js",
+  "front_end/panels/application/components/SharedStorageMetadataView.js",
   "front_end/panels/application/components/StackTrace.js",
   "front_end/panels/application/components/TrustTokensView.js",
   "front_end/panels/application/components/backForwardCacheView.css.js",
@@ -873,6 +875,8 @@ grd_files_debug_sources = [
   "front_end/panels/application/components/permissionsPolicySection.css.js",
   "front_end/panels/application/components/protocolHandlersView.css.js",
   "front_end/panels/application/components/reportingApiGrid.css.js",
+  "front_end/panels/application/components/sharedStorageAccessGrid.css.js",
+  "front_end/panels/application/components/sharedStorageMetadataView.css.js",
   "front_end/panels/application/components/stackTraceLinkButton.css.js",
   "front_end/panels/application/components/stackTraceRow.css.js",
   "front_end/panels/application/components/trustTokensView.css.js",
@@ -1030,9 +1034,6 @@ grd_files_debug_sources = [
   "front_end/panels/event_listeners/EventListenersUtils.js",
   "front_end/panels/event_listeners/EventListenersView.js",
   "front_end/panels/event_listeners/eventListenersView.css.js",
-  "front_end/panels/input/InputModel.js",
-  "front_end/panels/input/InputTimeline.js",
-  "front_end/panels/input/inputTimeline.css.js",
   "front_end/panels/issues/AffectedBlockedByResponseView.js",
   "front_end/panels/issues/AffectedCookiesView.js",
   "front_end/panels/issues/AffectedDirectivesView.js",
@@ -1081,7 +1082,6 @@ grd_files_debug_sources = [
   "front_end/panels/lighthouse/LighthouseReportSelector.js",
   "front_end/panels/lighthouse/LighthouseReporterTypes.js",
   "front_end/panels/lighthouse/LighthouseStartView.js",
-  "front_end/panels/lighthouse/LighthouseStartViewFR.js",
   "front_end/panels/lighthouse/LighthouseStatusView.js",
   "front_end/panels/lighthouse/LighthouseTimespanView.js",
   "front_end/panels/lighthouse/RadioSetting.js",
@@ -1136,10 +1136,16 @@ grd_files_debug_sources = [
   "front_end/panels/network/SignedExchangeInfoView.js",
   "front_end/panels/network/binaryResourceView.css.js",
   "front_end/panels/network/blockedURLsPane.css.js",
+  "front_end/panels/network/components/HeaderSectionRow.css.js",
+  "front_end/panels/network/components/HeaderSectionRow.js",
+  "front_end/panels/network/components/RequestHeaderSection.css.js",
+  "front_end/panels/network/components/RequestHeaderSection.js",
   "front_end/panels/network/components/RequestHeadersView.css.js",
   "front_end/panels/network/components/RequestHeadersView.js",
   "front_end/panels/network/components/RequestTrustTokensView.css.js",
   "front_end/panels/network/components/RequestTrustTokensView.js",
+  "front_end/panels/network/components/ResponseHeaderSection.css.js",
+  "front_end/panels/network/components/ResponseHeaderSection.js",
   "front_end/panels/network/components/WebBundleInfoView.css.js",
   "front_end/panels/network/components/WebBundleInfoView.js",
   "front_end/panels/network/eventSourceMessagesView.css.js",
@@ -1243,7 +1249,6 @@ grd_files_debug_sources = [
   "front_end/panels/sources/GoToLineQuickOpen.js",
   "front_end/panels/sources/InplaceFormatterEditorAction.js",
   "front_end/panels/sources/JavaScriptBreakpointsSidebarPane.js",
-  "front_end/panels/sources/JavaScriptCompilerPlugin.js",
   "front_end/panels/sources/NavigatorView.js",
   "front_end/panels/sources/OpenFileQuickOpen.js",
   "front_end/panels/sources/OutlineQuickOpen.js",
@@ -1265,6 +1270,7 @@ grd_files_debug_sources = [
   "front_end/panels/sources/breakpointEditDialog.css.js",
   "front_end/panels/sources/callStackSidebarPane.css.js",
   "front_end/panels/sources/components/BreakpointsView.js",
+  "front_end/panels/sources/components/BreakpointsViewUtils.js",
   "front_end/panels/sources/components/HeadersView.css.js",
   "front_end/panels/sources/components/HeadersView.js",
   "front_end/panels/sources/components/breakpointsView.css.js",
@@ -1328,7 +1334,6 @@ grd_files_debug_sources = [
   "front_end/panels/webauthn/webauthnPane.css.js",
   "front_end/services/puppeteer/PuppeteerConnection.js",
   "front_end/services/window_bounds/WindowBoundsService.js",
-  "front_end/third_party/acorn-loose/package/dist/acorn-loose.mjs",
   "front_end/third_party/acorn/package/dist/acorn.mjs",
   "front_end/third_party/chromium/client-variations/ClientVariations.js",
   "front_end/third_party/codemirror/package/addon/runmode/runmode-standalone.mjs",
@@ -1368,18 +1373,22 @@ grd_files_debug_sources = [
   "front_end/third_party/lit-html/package/lib/template.js",
   "front_end/third_party/lit-html/package/lit-html.js",
   "front_end/third_party/marked/package/lib/marked.esm.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/api/Browser.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/api/BrowserContext.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/api/Page.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Accessibility.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/AriaQueryHandler.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Browser.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserConnector.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserWebSocketTransport.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ChromeTargetManager.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Configuration.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Connection.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConnectionTransport.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConsoleMessage.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Coverage.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Debug.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DeviceDescriptors.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Device.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Dialog.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ElementHandle.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EmulationManager.js",
@@ -1390,17 +1399,20 @@ grd_files_debug_sources = [
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FirefoxTargetManager.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Frame.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameManager.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameTree.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPRequest.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPResponse.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Input.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/IsolatedWorld.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/JSHandle.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LazyArg.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LifecycleWatcher.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkConditions.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkEventManager.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkManager.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NodeWebSocketTransport.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PDFOptions.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PredefinedNetworkConditions.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Product.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Puppeteer.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PuppeteerViewport.js",
@@ -1412,38 +1424,41 @@ grd_files_debug_sources = [
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TimeoutSettings.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Tracing.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/USKeyboardLayout.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WaitTask.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WebWorker.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/bidi/Browser.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/bidi/BrowserContext.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/bidi/Connection.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/bidi/Page.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/fetch.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/types.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/util.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/compat.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/constants.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/environment.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/injected.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/version.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/initializePuppeteer.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/injected/PierceQuerySelector.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/injected/Poller.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/injected/TextContent.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/injected/TextQuerySelector.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/injected/XPathQuerySelector.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/injected/injected.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/injected/util.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserFetcher.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserRunner.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ChromeLauncher.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/FirefoxLauncher.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/LaunchOptions.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/NodeWebSocketTransport.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PipeTransport.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ProductLauncher.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Puppeteer.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/install.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/util.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PuppeteerNode.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer-core.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/revisions.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/types.js",
+  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/util/DebuggableDeferredPromise.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/util/DeferredPromise.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/util/ErrorLike.js",
   "front_end/third_party/puppeteer/package/lib/esm/puppeteer/util/assert.js",
-  "front_end/third_party/puppeteer/package/lib/esm/puppeteer/util/getPackageDirectory.js",
-  "front_end/third_party/puppeteer/package/lib/esm/vendor/mitt/src/index.js",
+  "front_end/third_party/puppeteer/package/lib/esm/third_party/mitt/index.js",
   "front_end/third_party/wasmparser/package/dist/esm/WasmDis.js",
   "front_end/third_party/wasmparser/package/dist/esm/WasmParser.js",
   "front_end/ui/components/adorners/Adorner.js",
@@ -1547,6 +1562,8 @@ grd_files_debug_sources = [
   "front_end/ui/components/tree_outline/TreeOutline.js",
   "front_end/ui/components/tree_outline/TreeOutlineUtils.js",
   "front_end/ui/components/tree_outline/treeOutline.css.js",
+  "front_end/ui/components/two_states_counter/TwoStatesCounter.js",
+  "front_end/ui/components/two_states_counter/twoStatesCounter.css.js",
   "front_end/ui/legacy/ARIAUtils.js",
   "front_end/ui/legacy/ActionRegistration.js",
   "front_end/ui/legacy/ActionRegistry.js",

package/config/gni/devtools_image_files.gni

@@ -62,6 +62,7 @@ devtools_svg_sources = [
   "close-icon.svg",
   "copy_icon.svg",
   "dropdown_7x6_icon.svg",
+  "edit-icon.svg",
   "elements_panel_icon.svg",
   "errorWave.svg",
   "error_icon.svg",
@@ -71,6 +72,8 @@ devtools_svg_sources = [
   "flex-direction-icon.svg",
   "flex-nowrap-icon.svg",
   "flex-wrap-icon.svg",
+  "frame-embedded-icon.svg",
+  "frame-icon.svg",
   "help_outline.svg",
   "ic_changes.svg",
   "ic_checkmark_16x16.svg",
@@ -149,6 +152,7 @@ devtools_svg_sources = [
   "switcherIcon.svg",
   "three_dots_menu_icon.svg",
   "trash_bin_icon.svg",
+  "trash_bin_material_icon.svg",
   "treeoutlineTriangles.svg",
   "triangle-collapsed.svg",
   "triangle-expanded.svg",

package/docs/README.md

@@ -0,0 +1,81 @@
+# Chromium DevTools docs
+
+This directory contains [Chrome DevTools] project
+documentation in [Gitiles-flavored Markdown]. It is automatically
+[rendered by Gitiles].
+
+[Chrome DevTools]: https://developer.chrome.com/docs/devtools/
+[Gitiles-flavored Markdown]: https://gerrit.googlesource.com/gitiles/+/master/Documentation/markdown.md
+[rendered by Gitiles]: https://chromium.googlesource.com/devtools/devtools-frontend/+/main/docs/
+
+**If you add new documents, please also add a link to them in the Document Index
+below.**
+
+[TOC]
+
+## Creating Documentation
+
+### Guidelines
+
+*   See the [Chromium Documentation Guidelines](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/documentation_guidelines.md)
+    and the
+    [Chromium Documentation Best Practices](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/documentation_best_practices.md).
+*   Markdown documents must follow the
+    [style guide](https://github.com/google/styleguide/tree/gh-pages/docguide).
+
+### Previewing changes
+
+#### Locally using [md_browser](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/tools/md_browser)
+
+Assuming that `/path/to/src` contains a chromium checkout, you can run:
+
+```bash
+# in devtools-frontend checkout
+/path/to/src/tools/md_browser/md_browser.py --directory $PWD/docs
+```
+
+This is only an estimate. The **gitiles** view may differ.
+
+#### Online with Gerrit's links to gitiles
+
+1.  Upload a patch to gerrit, or receive a review request.
+    e.g. https://chromium-review.googlesource.com/c/3362532
+2.  View a specific .md file.
+    e.g. https://chromium-review.googlesource.com/c/3362532/2/docs/README.md
+3.  You will see something like <br>
+    Base
+    [preview](https://chromium.googlesource.com/chromium/src/+/ad44f6081ccc6b92479b12f1eb7e9482f474859d/docs/README.md)
+    -> Patchset 3
+    [preview](https://chromium.googlesource.com/chromium/src/+/refs/changes/32/3362532/3/docs/README.md)
+    | DOWNLOAD <br>
+    at the top left of the page. Click on the second
+    "[preview](https://chromium.googlesource.com/chromium/src/+/refs/changes/32/3362532/3/docs/README.md)"
+    link to open the preview for the current patch set.
+
+This **gitiles** view is the authoritative view, exactly the same as will be
+used when committed.
+
+## Document Index
+
+### Design Documents
+*   See the shared [Design Documents](https://drive.google.com/drive/folders/1JbUthATfybvMQR3yAHC4J0P7n6oftYNq) folder in the Chromium drive.
+
+### General Development
+*   [Workflows](workflows.md)
+*   [Chrome DevTools Design Review Guidelines](design_guidelines.md)
+*   [Release Management](release_management.md)
+*   [Third-party Guidelines](third_party_guidelines.md)
+*   [Localization](l10n.md)
+*   [V8 debugger support checklist for new language features](https://goo.gle/v8-checklist)
+
+### Testing
+*   [E2E test guide](../test/e2e/README.md)
+*   [Web tests in the DevTools repo guide](../test/webtests/README)
+
+### Architectural Documentation
+*   [Architecture of DevTools](architecture_of_devtools.md)
+*   [Resource management in DevTools](resource_management.md)
+
+### Chromium
+*   [Chromium Docs](https://chromium.googlesource.com/chromium/src/+/master/docs/README.md)
+*   [V8 Documention](https://v8.dev/docs)

package/{ARCHITECTURE.md → docs/architecture_of_devtools.md}

@@ -111,17 +111,17 @@ Loading of core functionality and features is built on top of [JavaScript module
 Core functionality is loaded via static imports, while implementations of features is lazily loaded using [dynamic imports].
 Features themselves use static imports for loading core and feature-specific functionality.
 
-![A high-level overview of how feature implementations are lazily loaded in the DevTools startup process](./docs/images/architecture-lazy-loading-features.png)
+![A high-level overview of how feature implementations are lazily loaded in the DevTools startup process](architecture_of_devtools_lazy_loading_features.png)
 
 Enforcement of the rules regarding loading is implemented using the [ESLint] rule defined in [scripts/eslint_rules/lib/es_modules_import.js](scripts/eslint_rules/lib/es_modules_import.js).
 
 ## DevTools application entrypoints
 
 There are multiple variants of the DevTools application.
-The main DevTools application is [front_end/devtools_app.js](front_end/devtools_app/devtools_app.js), which developers can open via F12 or "Right click -> Inspect element" in their Chromium browser.
-Other application entrypoints are used when debugging via Node ([front_end/node_app.js](front_end/node_app/node_app.js)), a slimmed down V8-specific Node debugging context ([front_end/js_app.js](front_end/js_app/js_app.js)), a (service) worker context ([front_end/worker_app.js](front_end/worker_app/worker_app.js)), a standalone browser window ([front_end/toolbox.ts](front_end/toolbox/toolbox.ts)), remote debugging of (Android) devices with `chrome://inspect/#devices` ([front_end/inspector.js](front_end/inspector/inspector.js)), standalone Node debugger [ndb] ([front_end/ndb_app.js](front_end/ndb_app/ndb_app.js)) and a legacy entrypoint for Chromium layout tests ([front_end/integration_test_runner/integration_test_runner.js](front_end/integration_test_runner.js)).
+The main DevTools application is [devtools_app.ts](../front_end/entrypoints/devtools_app/devtools_app.ts), which developers can open via F12 or "Right click -> Inspect element" in their Chromium browser.
+Other application entrypoints are a dedicated tool for debugging Node on which multiple targets can be inspected ([node_app.ts](../front_end/entrypoints/node_app/node_app.ts)), a non-browser context debugger for V8 targets ([js_app.ts](../front_end/entrypoints/js_app/js_app.ts)), a (service) worker context ([worker_app.ts](../front_end/entrypoints/worker_app/worker_app.ts)), remote debugging of (Android) devices ([inspector.ts](../front_end/entrypoints/inspector/inspector.ts)) and a basic version of DevTools which was initially intended for non-browser targets but doesn't have any particular use case that differentiates it from the other variants ([ndb_app.ts](../front_end/entrypoints/ndb_app/ndb_app.ts)).
 
-Each application entrypoint has a corresponding `.html` file with the same name, that can be loaded by the Chromium DevTools backend.
+Each application entrypoint has a corresponding `.html` file with the same name, that is automatically in the frontend generated and can be loaded by the Chromium DevTools backend.
 The JavaScript files import the relevant "meta" files containing the declarations of DevTools features.
 
 ## Upfront declaration of DevTools features
@@ -275,7 +275,7 @@ Please favor using `ui/components` wherever possible.
 
 In general, the following structure is applicable to dependencies between modules:
 
-![An overview of allowed visibility rules of modules](./docs/images/module-visibility-rules.png)
+![An overview of allowed visibility rules of modules](architecture_of_devtools_module_visibility_rules.png)
 
 - `core/` can be imported by any module
 - `models/` can be imported by `panels/` and `entrypoints/`
@@ -402,6 +402,5 @@ The GRD file is placed in `gen/third_party/devtools-frontend/src/front_end/` in
 [GN `visibility` rules]: https://gn.googlesource.com/gn/+/main/docs/reference.md#var_visibility
 [GN `metadata` definitions]: https://gn.googlesource.com/gn/+/main/docs/reference.md#var_metadata
 [GRIT]: https://www.chromium.org/developers/tools-we-use-in-chromium/grit/grit-users-guide
-[ndb]: https://github.com/GoogleChromeLabs/ndb
 [Ninja]: https://ninja-build.org/
 [TypeScript]: https://www.typescriptlang.org/

package/docs/design_guidelines.md

@@ -10,6 +10,8 @@ This process puts the IC in charge, but also requires Chrome DevTools' leaders t
 1. Be kind and civilized.
 1. Be pragmatic.
 
+![DevTools Design Process](design_guidelines.png)
+
 ## Roles
 
 ### Individual Contributor (IC)
@@ -42,7 +44,7 @@ This is somebody who reviews and comments on the proposal. Their input should be
 
 _LGTM_: Not required. However, LGTM or non-LGTM is binding.
 
-Stuck proposals can be escalated to the [ENG_REVIEW_OWNERS](https://cs.chromium.org/chromium/src/third_party/devtools-frontend/src/config/owner/ENG_REVIEW_OWNERS) Potential use cases of such an escalation:
+Stuck proposals can be escalated to the [ENG_REVIEW_OWNERS](https://cs.chromium.org/chromium/src/third_party/devtools-frontend/src/config/owner/ENG_REVIEW_OWNERS). Potential use cases of such an escalation:
 
 - An LGTM provider is non-responsive.
 - No consensus on the design can be reached.