diff --git a/src/sig_stfl/sig_stfl.h b/src/sig_stfl/sig_stfl.h
index f3916438a4..3003a6d76a 100644
--- a/src/sig_stfl/sig_stfl.h
+++ b/src/sig_stfl/sig_stfl.h
@@ -165,7 +165,10 @@ OQS_API int OQS_SIG_STFL_alg_is_enabled(const char *method_name);
  */
 typedef struct OQS_SIG_STFL {
 
-	/** A local ordinal representing the OID parameter of the signature scheme. */
+	/** 
+	 * A local ordinal representing the LMS/XMSS OID parameter of the signature scheme. 
+	 * This OID is unrelated to ASN.1 OID or anything, it's only for LMS/XMSS internal usage.
+	 */
 	uint32_t oid;
 
 	/** Printable string representing the name of the signature scheme. */
@@ -271,7 +274,7 @@ typedef struct OQS_SIG_STFL_SECRET_KEY {
 	/* file storage handle */
 	void *context;
 
-	/* Secret key lock status: 0: key is locked, otherwise key is unlocked */
+	/* Secret key lock status boolean: (true) key is locked, (false) key is unlocked */
 	bool is_locked;
 
 	/**