Update k6-browser package documentation

chromium/browser.go

@@ -1,3 +1,4 @@
+// Package chromium is responsible for launching a Chrome browser process and managing its lifetime.
 package chromium
 
 import (

common/doc.go

@@ -1,3 +1,3 @@
-// Package common contains the implementation of API elements that do not
-// depend on the browser type.
+// Package common provides the main logic of the browser module.
+// This package will be split into multiple packages in the future.
 package common

common/js/doc.go

@@ -0,0 +1,4 @@
+// Package js provides JavaScript code that the browser module evaluates on the browser.
+// The common package uses this package.
+// `injected_script.js` is injected into each execution context.
+package js

keyboardlayout/layout.go

@@ -1,3 +1,4 @@
+// Package keyboardlayout provides keyboard key interpretation and layout validation.
 package keyboardlayout
 
 import (

log/logger.go

@@ -1,3 +1,4 @@
+// Package log provides logging for the browser module.
 package log
 
 import (

storage/storage.go

@@ -1,3 +1,4 @@
+// Package storage provides data storage for the extension and user specific data.
 package storage
 
 import (

tests/doc.go

@@ -1,2 +1,3 @@
-// Package tests contains integration tests.
+// Package tests provides integration tests.
+// The `testBrowser` type enables us to test the browser module with a real browser.
 package tests