Skip to content

Port browser redirect page, boards landing page, and add polls - #53

Merged
nschimme merged 5 commits into
MUME:masterfrom
nschimme:jules-11131407216632201627-23b8f0d5
Sep 8, 2026
Merged

Port browser redirect page, boards landing page, and add polls#53
nschimme merged 5 commits into
MUME:masterfrom
nschimme:jules-11131407216632201627-23b8f0d5

Conversation

@nschimme

@nschimme nschimme commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Summary by Sourcery

Expand the documentation site with browser play routing, a consolidated boards landing page, and historical and current player polls.

New Features:

  • Add a browser play redirect that routes mobile users to DecafMUD and desktop users to the MMapper demo.
  • Add a Boards overview page with links to MUME’s message boards.
  • Add a questionnaires and polls section covering historical survey results and the 2024 interactive report.

Bug Fixes:

  • Correct board and questionnaire links to use the current lowercase and site-local paths.
  • Update legacy browser-client links to point to the hosted documentation destinations.

Enhancements:

  • Integrate the Boards overview into site navigation and the resources landing page.
  • Improve the play and resource navigation with local documentation links.

Documentation:

  • Document historical MUME questionnaires from 1995, 1998, and 2000 alongside the 2024 poll.

- Created docs/play/browser.md with client-side screen width redirection.
- Updated play-mume links to https://docs.mume.org/play-mume/.
- Created docs/resources/boards/index.md and updated all board links across the site.
- Downloaded mudjc.jpg asset into docs/public/play/mudjc/.
- Ported play browser redirect script to docs/play/browser.md.
- Ported boards overview page to docs/resources/boards/index.md and updated all board links.
- Updated play-mume links to https://docs.mume.org/play-mume/.
- Downloaded mudjc.jpg asset into docs/public/play/mudjc/.
- Ported 1995, 1998, and 2000 player questionnaires into Markdown under docs/resources/questionnaires/.
- Port ./player/browser page to docs/play/browser.md with screen-width detection logic
- Update play-mume links across client docs to https://docs.mume.org/play-mume/
- Port boards landing page to docs/resources/boards/index.md and clean up links
- Port historical MUME player questionnaires (1995, 1998, 2000, 2024) and update navigation
- Fetch missing MUDjc screenshot asset into docs/public/play/mudjc/mudjc.jpg
…markdown file

- Remove docs/resources/questionnaires/2024-03.md
- Update questionnaires index and resources page to link directly to Looker Studio URL
@sourcery-ai

sourcery-ai Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Reviewer's Guide

This PR expands the documentation site with local Boards and questionnaire/poll landing pages, ports /play/browser to a responsive client-side redirect, and rewires navigation and historical links to the new routes and normalized board URLs.

Flow diagram for responsive browser client redirect

flowchart TD
    Browser[Browser visits /play/browser] --> Mounted[Vue onMounted]
    Mounted --> Width{screen.width <= 700}
    Width -->|Yes| Mobile[Redirect to docs.mume.org/play-mume/]
    Width -->|No| Desktop[Redirect to docs.mume.org/MMapper/demo]
    Mobile --> Fallback[Fallback link if redirect fails]
    Desktop --> Fallback
Loading

File-Level Changes

Change Details Files
Ports the browser play redirect into the VitePress site and updates client links to use the new route or hosted destinations.
  • Adds a responsive client-side redirect from /play/browser to MMapper on desktop and DecafMUD on narrow screens, with a fallback link.
  • Updates the play landing page and legacy browser page links to point at the new route or docs.mume.org targets.
docs/play/browser.md
docs/play/index.md
docs/play/browser-legacy.md
Adds a local Boards landing page and routes site navigation to it while normalizing board URLs.
  • Adds a Boards overview listing the game news, starter, FAQ, tales, Free People, and Orkish boards.
  • Changes header and resource navigation to use the local overview and lowercase board paths.
  • Updates historical news links to normalized board routes and the local April 2000 questionnaire page.
docs/resources/boards/index.md
docs/resources/index.md
docs/.vitepress/config.js
docs/.vitepress/theme/Layout.vue
docs/news/web.md
Introduces a questionnaires and polls section with historical survey result pages and a current external report.
  • Adds an overview linking to the March 2024 Looker Studio report and three historical questionnaire pages.
  • Publishes detailed 1995, 1998, and 2000 survey summaries with demographic, gameplay, satisfaction, and technical statistics.
  • Adds questionnaires and poll links to the resources index.
docs/resources/questionnaires/index.md
docs/resources/questionnaires/1995-09.md
docs/resources/questionnaires/1998-02.md
docs/resources/questionnaires/2000-04.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hey - I've found 1 issue

Prompt for AI Agents
Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="docs/.vitepress/config.js" line_range="58" />
<code_context>
           { text: 'Rules', link: 'https://mume.org/rules/' },
           { text: 'Dictionary', link: 'https://mume.org/dictionary/' },
-          { text: 'Boards', link: 'https://mume.org/resources/boards/' },
+          { text: 'Boards', link: '/resources/boards/' },
           { text: 'Download', link: 'https://mume.org/download/' },
           { text: 'Restricted', link: 'https://mume.org/restricted/' }
</code_context>
<issue_to_address>
**issue (broader_impact):** These new root-relative URLs ignore VitePress's configured base path. In GitHub Pages preview deployments, where `VITE_BASE` is a path such as `/pr-123/`, the Boards navigation points to the production-root `/resources/boards/` and the newly added page images request `/assets/...`, so the navigation and images return 404.

**Triggers:** When the site is built for a GitHub Pages preview or any deployment with a non-root `VITE_BASE`.

**Suggested fix:** Use `withBase('/resources/boards/')` for the config navigation link and base-aware asset URLs (or VitePress-resolved image paths) in the new Markdown pages.
</issue_to_address>

Sourcery assessment

Approval pending. 1 finding to address first.

Blocking findings: docs/.vitepress/config.js:58


Sourcery is free for open source - if you like our reviews please consider sharing them ✨

Comment thread docs/.vitepress/config.js
{ text: 'Rules', link: 'https://mume.org/rules/' },
{ text: 'Dictionary', link: 'https://mume.org/dictionary/' },
{ text: 'Boards', link: 'https://mume.org/resources/boards/' },
{ text: 'Boards', link: '/resources/boards/' },

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

issue (broader_impact): These new root-relative URLs ignore VitePress's configured base path. In GitHub Pages preview deployments, where VITE_BASE is a path such as /pr-123/, the Boards navigation points to the production-root /resources/boards/ and the newly added page images request /assets/..., so the navigation and images return 404.

Triggers: When the site is built for a GitHub Pages preview or any deployment with a non-root VITE_BASE.

Suggested fix: Use withBase('/resources/boards/') for the config navigation link and base-aware asset URLs (or VitePress-resolved image paths) in the new Markdown pages.

- Address code review comment regarding VitePress VITE_BASE preview paths
- Verify site build under custom VITE_BASE environment
@nschimme
nschimme merged commit e64b340 into MUME:master Sep 8, 2026
2 checks passed
@nschimme
nschimme deleted the jules-11131407216632201627-23b8f0d5 branch September 8, 2026 19:49
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