Skip to content

Comments

Document briefcase.debuggers plugin interface#2691

Merged
freakboy3742 merged 3 commits intobeeware:mainfrom
filiplajszczak:2681-doc-debuggers-plugin
Feb 17, 2026
Merged

Document briefcase.debuggers plugin interface#2691
freakboy3742 merged 3 commits intobeeware:mainfrom
filiplajszczak:2681-doc-debuggers-plugin

Conversation

@filiplajszczak
Copy link
Contributor

@filiplajszczak filiplajszczak commented Feb 16, 2026

Add a new briefcase.debuggers section to the plugins reference page describing the BaseDebugger abstract base class, its required properties, and entry point registration. Resolves #2681

Apply the scout rule to the rest of the plugins page:

  • Fix copy-paste bug in bootstraps section (entry point group name pointed to briefcase.platforms instead of briefcase.bootstraps)
  • Add #platform-interface anchor ID to the platforms heading
  • Standardize "For example" lead-in phrasing across all sections
  • Fix code block language tags from python to toml
  • Fix Xcode casing (XCode -> Xcode) and add to spelling wordlist

Link the debugger plugin interface from the build and run command reference pages, and link the platform plugin interface from the FAQ.

Groundwork for more plugin work in #2687

PR Checklist:

  • All new features have been tested
  • All new features have been documented
  • I have read the CONTRIBUTING.md file
  • I will abide by the code of conduct

filiplajszczak and others added 3 commits February 16, 2026 19:25
Add a new `briefcase.debuggers` section to the plugins reference page
describing the BaseDebugger abstract base class, its required properties,
and entry point registration.

Apply the scout rule to the rest of the plugins page:
- Fix copy-paste bug in bootstraps section (entry point group name
pointed to briefcase.platforms instead of briefcase.bootstraps)
- Add #platform-interface anchor ID to the platforms heading
- Standardize "For example" lead-in phrasing across all sections
- Fix code block language tags from python to toml
- Fix Xcode casing (XCode -> Xcode) and add to spelling wordlist

Link the debugger plugin interface from the build and run command
reference pages, and link the platform plugin interface from the FAQ.
Copy link
Member

@freakboy3742 freakboy3742 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this update, and for fixing the stray typos you picked up along the way.

I've fixed the remaining Xcode spelling issues, and added some additional details about the exact interface that a debugger must implemented.

Wunjo
Xauth
XCode
Xcode
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch on this - but we should also remove the XCode entry (and fix the problems that exist because of the bad entry...)

@freakboy3742 freakboy3742 merged commit ac7e307 into beeware:main Feb 17, 2026
132 of 134 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document briefcase.debuggers plugin interface in plugins reference

2 participants