docs: Update macOS guide; docs build mention in README
- Remove discussion of Python SSL issues on Mac; awhile ago code to
detect this issue and print a useful message was added.
- Mention that the docs need to be built on the front page; otherwise
the experience is a bit confusing.
Change-Id: I0c881b78e6f4e921f7688db7e647bc58f2e8b6c7
diff --git a/README.md b/README.md
index 74e8fe8..005bf84 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,10 @@
different Pigweed module offerings, refer to "Module Guides" section in the full
documentation.
+Note: For now the full documentation is not available online; you must build
+it. Building the docs is easy; see the [getting started
+guide](docs/getting_started.md) for how.
+
## `pw_watch` - Build, flash, run, & test on save
In the web development space, file system watchers are prevalent. These watchers
diff --git a/docs/getting_started.md b/docs/getting_started.md
index 21f351d..0f9e4e1 100644
--- a/docs/getting_started.md
+++ b/docs/getting_started.md
@@ -98,12 +98,6 @@
macOS does not require any prerequisites to be installed, but you may run into
some Mac-specific configuration issues when you begin the bootstrap process.
-If you're using Homebrew and you get an error saying
-`module 'http.client' has no attribute 'HTTPSConnection'` then your
-Homebrew Python was not set up to support SSL. Ensure it's installed with
-`brew install openssl` and then run
-`brew uninstall python && brew install python`.
-
To flash firmware to a STM32 Discovery development board (and run `pw test`)
from macOS, you will need to install OpenOCD. Install Homebrew using the latest
instructions at https://brew.sh/, then install OpenOCD with
