Skip to content

Conversation

@justinegeffen
Copy link
Contributor

@justinegeffen justinegeffen commented Dec 11, 2025

  • Added agents and a workflow to test how they work and scale
  • Based on publicly available documentation conventions.

Added Topic Structure Agent documentation for auditing compliance with CTRT framework.

Signed-off-by: Justine Geffen <[email protected]>
Signed-off-by: Justine Geffen <[email protected]>
Added voice-tone guidelines for documentation PRs, focusing on consistent voice, active tone, and present tense usage.

Signed-off-by: Justine Geffen <[email protected]>
Signed-off-by: Justine Geffen <[email protected]>
Signed-off-by: Justine Geffen <[email protected]>
Signed-off-by: Justine Geffen <[email protected]>
Signed-off-by: Justine Geffen <[email protected]>
Signed-off-by: Justine Geffen <[email protected]>
Signed-off-by: Justine Geffen <[email protected]>
@netlify
Copy link

netlify bot commented Dec 11, 2025

Deploy Preview for seqera-docs ready!

Name Link
🔨 Latest commit 8855a33
🔍 Latest deploy log https://app.netlify.com/projects/seqera-docs/deploys/696802943490440008c78eee
😎 Deploy Preview https://deploy-preview-955--seqera-docs.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.

Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Pre-commit formatting suggestions

Pre-commit hooks found some formatting changes. You can apply each suggestion directly by clicking the "Commit suggestion" button, or run pre-commit locally and commit again.

## Fixes Applied: [filename]

✅ Line 23: Third person → Second person
✅ Line 45: Product name standardization
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
✅ Line 45: Product name standardization
✅ Line 45: Product name standardization


1. Select **Launchpad** > **Add pipeline**.
2. Enter the repository URL.

Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change

# Maximum files per review batch (prevents timeout on large PRs)
max_files_per_batch: 20

# Output format for PR comments
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
# Output format for PR comments

- major_change # Run when >50% of file changed

# File patterns (glob)
patterns:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
patterns:

Use the terminology agent to review these changed documentation files:
${{ needs.changes.outputs.docs_files }}

Check for:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Check for:

Use the clarity agent to review these changed documentation files:
${{ needs.changes.outputs.docs_files }}

Check for:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Check for:

Use the inclusive-language agent to review these changed documentation files:
${{ needs.changes.outputs.docs_files }}

Check for:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Check for:

const statusEmoji = {
'success': '✅',
'failure': '❌',
'skipped': '⏭️',
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
'skipped': '⏭️',

prompt: |
Use the docs-fix agent to apply fixes to all changed documentation files in this PR.

Apply fixes for:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Apply fixes for:

justinegeffen and others added 3 commits January 12, 2026 18:19
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: Justine Geffen <[email protected]>
Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Pre-commit formatting suggestions

Pre-commit hooks found some formatting changes. You can apply each suggestion directly by clicking the "Commit suggestion" button, or run pre-commit locally and commit again.

# Focus only on RNA-Seq issues
./lint --no-heading-case platform-enterprise_docs/

# Focus only on heading issues
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
# Focus only on heading issues
# Focus only on heading issues

- Reason: [Google style guide principle or grammar rule]

+ Line Y: [original text]
- Issue: [description of problem]
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- Issue: [description of problem]
- Issue: [description of problem]

- Specific line-by-line corrections
- Suggestions for improvement
- Explanations of Google style guide principles
- A revised version if requested
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- A revised version if requested
- A revised version if requested


# Documentation Linter Shortcut
# Usage: ./lint [options] [directories...]
#
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
#
#

else
# Pass all arguments through to the linter
node "$LINTER_PATH" "$@"
fi No newline at end of file
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
fi
fi

@github-actions
Copy link
Contributor

📝 Documentation Review Summary

Check Status
CTRT Topic Structure ❌ failure
Page Structure ❌ failure
Voice/Tone ❌ failure
Terminology ❌ failure
Clarity ❌ failure
Inclusive Language ❌ failure

Review powered by Claude Code SME agents

To apply fixes: Comment /fix-docs on this PR

Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Pre-commit formatting suggestions

Pre-commit hooks found some formatting changes. You can apply each suggestion directly by clicking the "Commit suggestion" button, or run pre-commit locally and commit again.

else
# Pass all arguments through to the linter
node "$LINTER_PATH" "$@"
fi No newline at end of file
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
fi
fi

@github-actions
Copy link
Contributor

📝 Documentation Review Summary

Check Status
CTRT Topic Structure ❌ failure
Page Structure ❌ failure
Voice/Tone ❌ failure
Terminology ❌ failure
Clarity ❌ failure
Inclusive Language ❌ failure

Review powered by Claude Code SME agents

To apply fixes: Comment /fix-docs on this PR

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