Skip to content

Follow the debugging-guide merge, and make the extension findable - #25

Merged
shivamsn97 merged 1 commit into
mainfrom
docs/merge-debugging-guides
Jul 26, 2026
Merged

Follow the debugging-guide merge, and make the extension findable#25
shivamsn97 merged 1 commit into
mainfrom
docs/merge-debugging-guides

Conversation

@shivamsn97

Copy link
Copy Markdown
Member

Follows pyxle-dev/pyxle#58, which merges the framework's two debugging pages into one.

Docs side: the nav loses the "Debugging .pyxl files" entry, its search keywords fold into the single page, and the generated JSON for the removed page is deleted rather than left serving stale duplicate content. The old URL now returns a real 404 with the "Back to docs" page (the docs route already 404s unknown slugs properly), instead of a second, drifting copy of the guide.

The extension was effectively hidden. The homepage mentioned "the VS Code extension" once, in a sentence, with no link and no way to get it. The Studio and debugger section now has:

  • the install command code --install-extension pyxle.pyxle-language-tools with a copy button, in the same specimen style as pyxle studio
  • a plain statement that F5 needs it
  • a Get the VS Code extension ↗ link to the Marketplace, next to the two guide links

The /index.md twin gains an editor-setup entry carrying the same command.

Verified: pyxle check clean, docs regeneration is idempotent, the merged page renders with "Install the VS Code extension" as its first section and two working Marketplace links, and there is no horizontal overflow at 1280px or 375px (all seven code blocks scroll inside their own container).

The framework's two debugging pages are now one, so the nav loses the
"Debugging .pyxl files" entry, its search keywords fold into the single
page, and the generated JSON for the removed page is deleted rather than
left serving stale duplicate content — the old URL now returns a real 404
with the "Back to docs" page.

The homepage told a visitor the extension exists but never how to get it.
The Studio and debugger section now carries the install command with a
copy button, states that F5 needs it, and links to the Marketplace
alongside the two guides. The Markdown twin gains the editor-setup entry
with the same command.
@shivamsn97
shivamsn97 merged commit 84bd349 into main Jul 26, 2026
@shivamsn97
shivamsn97 deleted the docs/merge-debugging-guides branch July 26, 2026 08:47
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.

1 participant