Skip to content

Conversation

pinin4fjords
Copy link
Collaborator

Improve debugging module clarity and usability

Enhances the debugging side quest with better organization, consistent terminology, and improved learning aids.

Key Changes

Usability Improvements

  • Added Quick Debugging Reference card in Summary for at-a-glance lookup
  • Added tip box introducing .view() at start of Section 2 (Channel Errors)
  • Converted all code fixes to Before/After tab format (8 examples)

Content Cleanup

  • Removed redundant content (~32 lines):
    • Duplicate work directory file descriptions
    • Overlapping systematic debugging approaches
    • Repeated Summary content
  • Streamlined introduction by removing redundant error type lists

Clarity Improvements

  • Renamed Section 1.5: "Bad practice syntax errors..." → "Non-Fatal Syntax Warnings"
  • Standardized terminology: "work directory" (fixed 3 inconsistencies)

Result

More streamlined module with better progressive disclosure, practical reference materials, and consistent terminology while preserving all essential content.

Copy link

netlify bot commented Oct 13, 2025

Deploy Preview for nextflow-training ready!

Name Link
🔨 Latest commit 5034c9d
🔍 Latest deploy log https://app.netlify.com/projects/nextflow-training/deploys/68ed2d061b216300081eb50a
😎 Deploy Preview https://deploy-preview-675--nextflow-training.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@pinin4fjords pinin4fjords requested a review from vdauwera October 13, 2025 15:15
@pinin4fjords pinin4fjords merged commit 64b26ef into master Oct 14, 2025
8 checks passed
@pinin4fjords pinin4fjords deleted the tighten_debugging branch October 14, 2025 14:10
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.

2 participants