Add constructor for DioExceptionType.badCertificate

[hgraceb]

• Improve some document comments.
• Change the parameter position of DioException's constructors to make it most readable.
• Add constructor for DioExceptionType.badCertificate. There is also one reference in the plugin http2_adapter. But I don't know if changing that with an upgraded version is necessary.
  

  dio/plugins/http2_adapter/lib/src/connection_manager_imp.dart

  Lines 110 to 115 in 1c2843a

  	throw DioException(
  	requestOptions: options,
  	type: DioExceptionType.badCertificate,
  	error: certificate,
  	message: 'The certificate of the response is not approved.',
  	);

New Pull Request Checklist

• I have read the Documentation
• I have searched for a similar pull request in the project and found none
• I have updated this branch with the latest main branch to avoid conflicts (via merge from master or rebase)
• I have added the required tests to prove the fix/feature I'm adding
• I have updated the documentation (if necessary)
• I have run the tests without failures
• I have updated the CHANGELOG.md in the corresponding package

Additional context and info (if any)

[github-actions]

Code Coverage Report

Package	Base Coverage	New Coverage	Difference
dio	🟢 80.26%	🟢 81.24%	🟢 0.98%
Overall Coverage	🟢 80.26%	🟢 81.24%	🟢 0.98%

Minimum allowed coverage is 0%, this run produced 81.24%

[ueman]

There is also one reference in the plugin http2_adapter. But I don't know if changing that with an upgraded version is necessary.

I'm fine with adding a comment there or creating an issue to fix it later. That way we don't forget about it.

[hgraceb]

I'm fine with adding a comment there or creating an issue to fix it later. That way we don't forget about it.

I updated and added a TODO comment to do that. What do you think?

+// TODO(EVERYONE): Replace with DioException.badCertificate once upgrade dependencies Dio above 5.4.2.
 throw DioException(
   requestOptions: options,
   type: DioExceptionType.badCertificate,
   error: certificate,
   message: 'The certificate of the response is not approved.',
 );

[kuhnroyal]

@hgraceb Our pipeline should be fine now. Can you please rebase or merge main?

[hgraceb]

@kuhnroyal Nice works!