Add additional possible error for roda server

[KonnorRogers]

This is a 🔦 documentation change.

Summary

I had an error that didn't quite match the upgrade guide and didn't quite give enough info what was happening.

Context

Full error (for anyone searching)

➜  docs git:(konnorrogers/major-overhaul) ✗ bin/bridgetown start
[Bridgetown]           Starting: Bridgetown v2.0.0.beta2 (codename "(TBD!)")
[Bridgetown]
[Bridgetown]    Booting Puma at: http://0.0.0.0:4000
[Bridgetown]
Progress: resolved 1, reused 0, downloaded 0, added 0
 WARN  deprecated [email protected]: Glob versions prior to v9 are no longer supported
 WARN  deprecated [email protected]: Glob versions prior to v9 are no longer supported
 WARN  2 deprecated subdependencies found: @material/[email protected], [email protected]
Packages: +1 -3
+---
 WARN  2 deprecated subdependencies found: @material/[email protected], [email protected]
Packages: +1 -3
+---
Progress: resolved 227, reused 205, downloaded 0, added 0, done

dependencies:
- bridgetown-quick-search 2.0.0
+ bridgetown-quick-search 3.0.3

Done in 2.1s
Done in 2.2s
Stopping Bridgetown server...
/Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/3.3.0/bundled_gems.rb:74:in `set_encoding': Interrupt
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/3.3.0/bundled_gems.rb:74:in `require'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/3.3.0/bundled_gems.rb:74:in `block (2 levels) in replace_require'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/zeitwerk-2.6.17/lib/zeitwerk/kernel.rb:34:in `require'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/rake-13.2.1/lib/rake.rb:49:in `<top (required)>'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/3.3.0/bundled_gems.rb:74:in `require'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/3.3.0/bundled_gems.rb:74:in `block (2 levels) in replace_require'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/zeitwerk-2.6.17/lib/zeitwerk/kernel.rb:34:in `require'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-core-2.0.0.beta2/lib/bridgetown-core/commands/build.rb:53:in `build'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/command.rb:28:in `run'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:127:in `invoke_command'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:134:in `block in invoke_all'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:134:in `each'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:134:in `map'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:134:in `invoke_all'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/group.rb:232:in `dispatch'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/base.rb:584:in `start'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-core-2.0.0.beta2/lib/bridgetown-core/commands/start.rb:93:in `block (2 levels) in start'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-core-2.0.0.beta2/lib/bridgetown-core/commands/start.rb:93:in `fork'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-core-2.0.0.beta2/lib/bridgetown-core/commands/start.rb:93:in `block in start'
        from <internal:kernel>:90:in `tap'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-core-2.0.0.beta2/lib/bridgetown-core/commands/start.rb:86:in `start'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/command.rb:28:in `run'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:127:in `invoke_command'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:134:in `block in invoke_all'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:134:in `each'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:134:in `map'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:134:in `invoke_all'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/group.rb:232:in `dispatch'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:116:in `invoke'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor.rb:40:in `block in register'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/command.rb:28:in `run'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/invocation.rb:127:in `invoke_command'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor.rb:527:in `dispatch'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/thor-1.3.1/lib/thor/base.rb:584:in `start'
        from /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-core-2.0.0.beta2/bin/bridgetown:30:in `<top (required)>'
        from bin/bridgetown:27:in `load'
        from bin/bridgetown:27:in `<main>'
[Bridgetown] Stopping auxiliary processes...
[Bridgetown]   Exception raised: Errno::ENOENT
[Bridgetown] No such file or directory @ rb_sysopen - /Users/konnor/projects/oss/doxxing-time-layouts/rhino-editor/docs/tmp/pids/aux.pid
[Bridgetown]                  1: /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-foundation-2.0.0.beta2/lib/bridgetown/foundation/packages/pid_tracker.rb:15:in `readlines'
[Bridgetown]                  2: /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-foundation-2.0.0.beta2/lib/bridgetown/foundation/packages/pid_tracker.rb:15:in `read_pidfile'
[Bridgetown]                  3: /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-core-2.0.0.beta2/lib/bridgetown-core/utils/aux.rb:51:in `kill_processes'
[Bridgetown]                  4: /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-core-2.0.0.beta2/lib/bridgetown-core/commands/start.rb:104:in `block (2 levels) in start'
[Bridgetown]                  5: /Users/konnor/.asdf/installs/ruby/3.3.4/lib/ruby/gems/3.3.0/gems/bridgetown-core-2.0.0.beta2/lib/bridgetown-core/commands/start.rb:11:in `ensure in start'
[Bridgetown]          Backtrace: Use the --trace option for complete information.

[render]

Your Render PR Server URL is https://bridgetown-beta-pr-910.onrender.com.

Follow its progress at https://dashboard.render.com/static/srv-cr5ckadds78s73dn0nn0.

[render]

Your Render PR Server URL is https://bridgetown-api-pr-910.onrender.com.

Follow its progress at https://dashboard.render.com/static/srv-cr5ckbdds78s73dn0o1g.

[jaredcwhite]

@KonnorRogers Sounds good, but could you remove some of your local paths/machine-specific info? Maybe just condense the error message a bunch, I feel like having a full console output in the docs would be confusing.

[jaredcwhite]

@KonnorRogers ping =)

[ayushn21]

I've just push a change to simplify the trace ... hope you don't mind @KonnorRogers :)

[KonnorRogers]

Oops dropped the ball on this one 🙈 thanks @ayushn21 , also thank you GitHub notifications for being useless.