`swag init` breaks `make critic`

[p3nj]

Required check list:

• [x] I'm gonna mark the checkboxes like this.
• [x] I didn't find in the repository's issues section similar bug.
• [x] I understand, this is Open Source and not-for-profit product.
• [x] This is not about third-party project, framework, package or technology.

My environment:

• OS (uname -a): Darwin Maccie.local 21.5.0 Darwin Kernel Version 21.5.0: Tue Apr 26 21:08:29 PDT 2022; root:xnu-8020.121.3~4/RELEASE_ARM64_T8101 arm64
• Golang (go version): go version go1.18.2 darwin/arm64

Describe the bug:

swag init will break make critic

1. first time $ make critic have no error output
2. use $ swag init regenerate swag documents, include docs.go
3. run $ make critic again.
4. See output

   ./docs/docs.go:2:1: codegenComment: comment should match `Code generated .* DO NOT EDIT.` regexp
   make: *** [critic] Error 1

   Expected behavior:

$ make critic should exit without issue after $ swag init

Screenshots:

Additional context:

$ swag init also won't read the @BasePath defines inside main.go. Will have to manually add /api to all API endpoints in order to make Swagger UI work.

[welcome[bot]]

Thanks for opening your first issue here! 🎉 Be sure to follow the issue template!

[p3nj]

I realised that this issue was raised by go-critic. moving there.