Skip to content

Feat/add option/no colon list formatting #15

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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
@@ -19,6 +19,8 @@ export interface Options {
disableConsistencyGuidance?: boolean;
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