A Hero's Way

Technical writer turned front-end developer

Making complex things clear and usable.

From trophy guides to front-end development, clarity has been the through-line.

Explore my journey

I started writing trophy guides after finding inefficient or abandoned resources—and changed requirements that existing guides never covered. Improving that experience grew into years of hands-on UX/UI work, then into front-end development and systems thinking.

2018–2025

Documentation & UX/UI

Started writing guides in late 2018. Developed my approach to usable, maintainable documentation on TrueTrophies (2018–2024) and Blogger (2020–2025).

Sep 2025–May 2026

Web & mobile development

Began formal study, then continued through self-directed learning as my pace and learning style moved beyond the coursework.

Sep 2025–Oct 2026

Systems thinking

Developed the structural framework behind my portfolio, connecting content, interface, and the systems that support them.

Foundational guide projects

Dev Log: Refactoring a Broken Blog into a High-Speed Content Pipeline

From Compose View to Platform Architecture

When PSTrophyGuides began in 2020, the site relied heavily on Blogger's default Compose View and a lightly modified pre-built theme.

As the platform grew and guide complexity increased, the limitations of that foundation became increasingly difficult to ignore.

Rather than abandon the project, I used it as an opportunity to teach myself front-end development and rebuild the platform around scalability, maintainability, and long-term documentation standards.


Phase 1: Diagnosing the Bottleneck

Blogger's visual editor generates large amounts of inline styling, creating bloated and difficult-to-maintain markup.

What initially felt convenient eventually became a significant obstacle as the archive expanded.

Primary Issues
  • Limited Scalability: Small visual changes often required manual updates across numerous guides.
  • Mobile Fragmentation: Inline styling frequently produced inconsistent layouts on smaller screens.
  • Workflow Friction: Formatting became increasingly time-consuming as guides grew larger.

Phase 2: Architectural Rebuild

The solution was to separate content from presentation entirely.

I rebuilt the platform using custom HTML and CSS, replacing visual-editor generated markup with reusable structural components.

Key Improvements
  • Custom PlayStation-inspired interface design.
  • Reusable guide components.
  • Centralized stylesheet architecture.
  • Improved mobile responsiveness.
  • Reduced maintenance overhead.

Site-wide visual updates can now be performed from a centralized stylesheet rather than through manual post-by-post edits.


Phase 3: Workflow Automation

Modernizing the visual infrastructure solved only part of the problem.

The next challenge was improving production speed without sacrificing consistency.

To accomplish this, I created a library of reusable HTML snippets and component templates within Visual Studio Code.

Benefits
  • Consistent guide formatting.
  • Reduced repetitive coding.
  • Faster publication workflows.
  • Standardized content architecture.

Real-World Results

The effectiveness of the system became particularly visible during periods of rapid content production.

Within a four-day span, multiple large-scale guide projects were published, including:

  • Master Detective Archives: RAIN CODE+
  • Danganronpa V3: Killing Harmony
  • Danganronpa S: Ultimate Summer Camp
  • Process of Elimination

Achieving that level of output would have been significantly more difficult under the original workflow.


The Takeaway

This project reinforced an important lesson:

Effective development is not simply writing code that works. It is creating systems that reduce friction, improve maintainability, and enable future work to scale efficiently.

By rebuilding PSTrophyGuides around reusable components, centralized styling, and standardized workflows, a hobby project evolved into a long-term documentation platform with its own architecture, tooling, and development standards.

Build the system once. Reuse it forever.

No comments:

Post a Comment