@stevenhua0320, ready to review

You could remove the comma to make it not conflict for the pre-commit hook. The purpose now is to make the pre-commit workflow passing. Also, per our convention, we would make the title with chore: ... More details about how we name these is documented in the scikit-package webpage.

@stevenhua0320 Unfortunately, it does not seem to be as simple as removing the comma. I tried moving the multiline string to the final dictionary entry and removing the trailing comma, but Black adds the comma back automatically. I also tried replacing the triple-quoted string with concatenated strings using explicit \n\n, and that still did not get both hooks to agree.

At this point, the issue appears to be a formatter interaction rather than just the placement of that comma, so I’m looking for a change that will make both Black and docformatter pass consistently without altering behavior.

Perhaps there is a way to fix this in the .yaml

@stevenhua0320 Unfortunately, it does not seem to be as simple as removing the comma. I tried moving the multiline string to the final dictionary entry and removing the trailing comma, but Black adds the comma back automatically. I also tried replacing the triple-quoted string with concatenated strings using explicit \n\n, and that still did not get both hooks to agree.

At this point, the issue appears to be a formatter interaction rather than just the placement of that comma, so I’m looking for a change that will make both Black and docformatter pass consistently without altering behavior.

Perhaps there is a way to fix this in the .yaml

Two ways you could try:

1. Take docformatter with a specific commit image but not yet released version. I'm not sure whether the conflict is coming from some bug feature from docformatter with the released version but we could try on another committed image and see if it could get around the problem.
2. Try to add strict rule for one linter that it must conform to another linter's rule. I think for this you need to edit pyproject.toml and add the line black = true under [tool.docformatter] section and see whether it works.