update doc

README.md

@@ -80,12 +80,6 @@ can dynamically launch a browser for each remote driver with customizable browse
 It's [tuned](lib/docker/Dockerfile) for screenshots and fonts among popular natural languages.
 You can easily load balance requests to the cluster of this image, each container can create multiple browser instances at the same time.
 
-You can also use it to launch a browser manually:
-
-```bash
-docker run -p 9222:9222 rodorg/rod chromium-browser --headless --no-sandbox --remote-debugging-port=9222 --remote-debugging-address=0.0.0.0
-```
-
 ### Q: Why there is always an "about:blank" page
 
 It's an issue of the browser itself. If we enable the `--no-first-run` flag and we don't create a blank page, it will create a hello page which will consume more power.

examples_test.go

@@ -136,14 +136,14 @@ func Example_timeout_handling() {
 
 // We use "Must" prefixed functions to write example code. But in production you may want to use
 // the no-prefix version of them.
-// About why we use "Must" as the prefix, it's similar with https://golang.org/pkg/regexp/#MustCompile
+// About why we use "Must" as the prefix, it's similar to https://golang.org/pkg/regexp/#MustCompile
 func Example_error_handling() {
 	page := rod.New().MustConnect().MustPage("https://example.com")
 
 	// The two code blocks below are basically the same:
 
-	// The block below is better for production code. It follows the standards of golang error handling.
-	// Usually, this style will make error handling more consistent and precisely.
+	// The block below is better for production code. It's the standard error handling.
+	// Usually, this style is more consistent and precisely.
 	{
 		el, err := page.Element("a")
 		if err != nil {
@@ -158,9 +158,10 @@ func Example_error_handling() {
 		fmt.Println(html)
 	}
 
-	// The block below is better for example code or quick scripting. We use panic to short-circuit logics.
-	// So that we can code in fluent style: https://en.wikipedia.org/wiki/Fluent_interface
-	// It will reduce the code to type, but it may also catch extra errors (less consistent and precisely).
+	// The block below is better for debugging or quick scripting. We use panic to short-circuit logics.
+	// So that we can take advantage of fluent interface (https://en.wikipedia.org/wiki/Fluent_interface)
+	// and fail-fast (https://en.wikipedia.org/wiki/Fail-fast).
+	// This style will reduce code, but it may also catch extra errors (less consistent and precisely).
 	{
 		err := rod.Try(func() {
 			fmt.Println(page.MustElement("a").MustHTML())

lib/cdp/client.go

@@ -1,3 +1,4 @@
+// Package cdp for application layer communication with browser.
 package cdp
 
 import (

lib/examples/remote-launch/main.go

@@ -9,8 +9,11 @@ import (
 )
 
 func main() {
-	// Launch browser remotely
+	// To launch remote browsers, you need a remote launcher service,
+	// Rod provides a docker image for beginers, make sure have started:
 	// docker run -p 9222:9222 rodorg/rod
+	//
+	// For more information, check the doc of launcher.RemoteLauncher
 	l := launcher.MustNewRemote("ws://localhost:9222")
 
 	// Manipulate flags like the example in examples_test.go
@@ -27,3 +30,15 @@ func main() {
 
 	utils.Pause()
 }
+
+func hardcoreStyle() {
+	// You can also manually launch a browser in the image:
+	// docker run -p 9222:9222 rodorg/rod chromium-browser --headless --no-sandbox --remote-debugging-port=9222 --remote-debugging-address=0.0.0.0
+	u := launcher.MustResolveURL("9222")
+
+	browser := rod.New().ControlURL(u).MustConnect()
+
+	fmt.Println(
+		browser.MustPage("https://github.com").MustEval("() => document.title"),
+	)
+}

lib/launcher/launcher.go

@@ -1,3 +1,4 @@
+// Package launcher for launching browser utils.
 package launcher
 
 import (

query.go

@@ -325,7 +325,7 @@ func (p *Page) Race() *RaceContext {
 	return &RaceContext{page: p, noSleepPage: p.Sleeper(nil)}
 }
 
-// Element the doc is similar with MustElement but has a callback when a match is found
+// Element the doc is similar to MustElement but has a callback when a match is found
 func (rc *RaceContext) Element(selector string, callback func(*Element) error) *RaceContext {
 	rc.branches = append(rc.branches, &raceBranch{
 		func() (*Element, error) { return rc.noSleepPage.Element(selector) },
@@ -334,7 +334,7 @@ func (rc *RaceContext) Element(selector string, callback func(*Element) error) *
 	return rc
 }
 
-// ElementX the doc is similar with ElementX but has a callback when a match is found
+// ElementX the doc is similar to ElementX but has a callback when a match is found
 func (rc *RaceContext) ElementX(selector string, callback func(*Element) error) *RaceContext {
 	rc.branches = append(rc.branches, &raceBranch{
 		func() (*Element, error) { return rc.noSleepPage.ElementX(selector) },
@@ -343,7 +343,7 @@ func (rc *RaceContext) ElementX(selector string, callback func(*Element) error)
 	return rc
 }
 
-// ElementR the doc is similar with ElementR but has a callback when a match is found
+// ElementR the doc is similar to ElementR but has a callback when a match is found
 func (rc *RaceContext) ElementR(selector, regex string, callback func(*Element) error) *RaceContext {
 	rc.branches = append(rc.branches, &raceBranch{
 		func() (*Element, error) { return rc.noSleepPage.ElementR(selector, regex) },
@@ -352,7 +352,7 @@ func (rc *RaceContext) ElementR(selector, regex string, callback func(*Element)
 	return rc
 }
 
-// ElementByJS the doc is similar with MustElementByJS but has a callback when a match is found
+// ElementByJS the doc is similar to MustElementByJS but has a callback when a match is found
 func (rc *RaceContext) ElementByJS(opts *EvalOptions, callback func(*Element) error) *RaceContext {
 	rc.branches = append(rc.branches, &raceBranch{
 		func() (*Element, error) { return rc.noSleepPage.ElementByJS(opts) },