better documentation INil and INotNil

Author: lainio

assert/assert.go

@@ -303,6 +303,11 @@ func Nil[T any](p *T, a ...any) {
 
 // INil asserts that the interface value IS nil. If it is it panics/errors
 // (default Asserter) with the given message.
+//
+// Note, use this only for real interface types. Go's interface's has two values
+// so this won't work e.g. slices! Read more information about interface type.
+//
+//	https://go.dev/doc/faq#nil_error
 func INil(i any, a ...any) {
 	if i != nil {
 		defMsg := assertionMsg + ": interface should be nil"
@@ -312,6 +317,11 @@ func INil(i any, a ...any) {
 
 // INotNil asserts that the interface value is NOT nil. If it is it
 // panics/errors (default Asserter) with the given message.
+//
+// Note, use this only for real interface types. Go's interface's has two values
+// so this won't work e.g. slices! Read more information about interface type.
+//
+//	https://go.dev/doc/faq#nil_error
 func INotNil(i any, a ...any) {
 	if i == nil {
 		defMsg := assertionMsg + ": interface shouldn't be nil"