Refactor path mark guide into reusable help center system - #1274
Merged
Conversation
Replace the one-shot 4-slide path mark guide tour with a reusable Help Center that can be opened anytime from "?" entry points: - Generic HelpCenter framework (modal host + "?" button + topic registry) so other guides can join as topics later; content components are container-agnostic for a future standalone page. - Path mark topic with 4 sections: mental-model intro with a colored directory-tree diagram, a 12-recipe example gallery (movies, anime, manga, music) covering every capability (any-level matching, regex, dynamic properties/libraries, filters, boundary, scope, priority, scheduled sync, identity keeping), a comparison table against typical media managers, and a concept glossary with deep-link targeting. - "?" entry points on path-mark-config, path-marks, media library page (empty state + bottom hint), MarkConfigModal title (jumps to examples), pending-sync modal and path mark settings (jump to the sync concept). - First-run auto-open now shows the help center (same storage key as the old guide) and the legacy PathMarkGuide carousel plus its 50 orphaned locale keys are removed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019cZsnxTrB8kXtbT2Z5faq3
- Left navigation always visible: one overview entry per topic plus a grouped list of its concept entries; concepts move out of the fourth horizontal tab into the sidebar, each with its own detail page. - Topic overview keeps 3 horizontal tabs (what-is / examples / comparison); modal title simplifies to just "Help Center" since the topic name now lives in the navigation. - Widen the modal from 5xl to 6xl and raise the content height. - Concept deep links now select the sidebar entry (sync-related "?" buttons updated accordingly). Closes #1273 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019cZsnxTrB8kXtbT2Z5faq3
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Replaces the single-purpose
PathMarkGuideModalwith a generalizedHelpCentersystem that can host multiple topics and guides. The path mark guide is now the first topic in this extensible help center, with support for tabbed sections, concept glossary, and example gallery.Key Changes
Removed:
PathMarkGuideModalandusePathMarkGuide(path-mark-specific carousel-based guide)Added: New
HelpCentercomponent system:HelpCenterModal— main modal host with left navigation (topics + concepts) and right content paneHelpCenterButton— reusable "?" entry point to open help at any topic/sectionuseFirstRunHelp— generic first-run detection hook (replaces path-mark-specific version)topics.tsxfor easy addition of new guidesPath Mark Topic — refactored guide content into three tabbed sections:
Localization: Added comprehensive i18n keys for English and Chinese (
helpCenter.json)Shared Components:
DirectoryTree— renders sample folder structures with mark highlights (used by diagram, examples, and concepts)PathMarkExampleinterface — structured example definitions with abilities, mark types, and tree linesIntegration: Updated path mark config pages to use new
HelpCenterButtonanduseFirstRunHelpinstead of old guideImplementation Details
topics.tsxregistry; new guides simply add an entryuseFirstRunHelp(storageKey)) rather than path-mark-specificPathMarkExample[]array, making it easy to add or modify scenarioshttps://claude.ai/code/session_019cZsnxTrB8kXtbT2Z5faq3