Skip to content

Conversation

atsushifx
Copy link

✨ Overview

This PR introduces a new option no-ai-colon-list-formatting to the ai-tech-writing-guideline rule. The motivation is to allow flexibility for users who prefer colon + list formats without receiving unnecessary warnings.

By enabling this option, the rule will skip checks that flag colon-terminated sentences followed by bullet lists as mechanical.


🔧 Changes

List the key changes included in this PR:

  • Added/updated files or modules (ai-tech-writing-guideline.ts)
  • Removed deprecated logic or configs
  • Refactored for clarity/performance
  • Other

📂 Related Issues

No related issues.


✅ Checklist

Please confirm the following before requesting review:

  • Lint checks pass
  • Tests pass
  • Documentation is updated (if applicable)
  • PR title follows Conventional Commits
  • Descriptions and examples are clear

💬 Additional Notes

✅ Lint and test passed in local PR (#1)

Test cases were added to validate the behavior when the option is enabled or disabled. By default, colon + list still produces warnings, preserving current rule behavior.

atsushifx added 2 commits July 5, 2025 02:56
- Add an option to disable the colon + list formatting rule to reduce overly strict warnings
- Add tests for enabling/disabling the new option in ai-tech-writing-guideline.test.ts
disableClarityGuidance?: boolean;
disableStructureGuidance?: boolean;
// Disable colon + list formatting checks (allows colon followed by bullet points)
"no-ai-colon-list-formatting"?: boolean;
Copy link
Member

Choose a reason for hiding this comment

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

I would like to align the name with other options and name it disableColonListFormatting.

Copy link
Author

Choose a reason for hiding this comment

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

I have one question. This rule's name uses camelCase.
It's diffrent from other textlint rules name using kebab-case.

Is this new standard of new textlint rule set?

BTW, I change the name of options.

Copy link
Member

Choose a reason for hiding this comment

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

This is option name, it is not rule name.

@azu
Copy link
Member

azu commented Jul 5, 2025

I thought the : + CodeBlock combination had the same problem, so I plan to carve out this check as a separate rule.

@azu
Copy link
Member

azu commented Jul 5, 2025

I think the above PR will solve the problem, so I will close this PR.
Please see #17 (comment)

Thanks for the PR!

@azu azu closed this Jul 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Type: Feature New Feature
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants