Troubleshooting docs for Pear & Bare (#184)

* Add Troubleshooting guide stub w/ info on Pear.teardown & worker hang

* Add troubleshooting steps for debugging Pear app exiting silently

* Add troubleshoot entry on debugging `Error: While lock file...`

* Add troubleshooting entry on debugging slow hyperswarm joins

* Add entry for debugging running Bare modules in Pear desktop

* Add troubleshooting stub for Bare w/ info on bare vs node modules

* Add debugging guide for `bare-pack` w/ dynamic conditional imports

* Fix Node.js spelling & module -> package typo

* Link to 'nodejs compatibility' alias section in Bare troubleshooting

* Fix missing extension in link

* Add entry for debugging `ADDON_NOT_FOUND`

* Fix typo in troubleshooting guide for bare

* Add links to troubleshooting articles in SUMMARY.md & README.md

* Update Pear troubleshooting article title

* Refine reasons for joining Hyperswarm topics & fix minor formatting

* Clarify that aliases are for Bare support & dont prevent Node.js support

* Rework aliases description

Now it's clearer that its to add support and doesn't modify the
dependencies.

* Remove unnecessary `-d` in Pear troubleshooting guide
This commit is contained in:
Sean Zellmer
2025-05-15 13:29:45 -05:00
committed by GitHub
parent b5c4873f37
commit a35091a267
4 changed files with 181 additions and 0 deletions

View File

@@ -19,6 +19,7 @@ References for Pear Runtime.
* [Command-Line-Interface (CLI)](./reference/pear/cli.md)
* [Application-Programming-Interface (API)](./reference/pear/api.md)
* [Application Configuration](./reference/pear/configuration.md)
* [Troubleshooting Applications](./reference/pear/troubleshooting.md)
> The Pear Runtime uses [Bare](https://github.com/holepunchto/bare) JavaScript runtime, which is a small and modular JavaScript runtime for desktop and mobile. To learn more, see [Bare Reference](./reference/bare/overview.md).