Add doc warnings for unstable methods

docs/api.rst

@@ -1079,9 +1079,11 @@ See details at :ref:`owned_types_concept`
 .. c:function:: const z_loaned_hello_t * z_hello_loan(const z_owned_hello_t * hello)
 
 
-Serialization (unstable)
+Serialization
 ========================
 
+.. warning:: This API has been marked as unstable: it works as advertised, but it may be changed in a future release.
+
 Types
 -----
 

include/zenoh-pico/api/constants.h

@@ -136,6 +136,8 @@ typedef enum {
  * Enumerators:
  *     Z_RELIABILITY_BEST_EFFORT: Defines reliability as ``BEST_EFFORT``
  *     Z_RELIABILITY_RELIABLE: Defines reliability as ``RELIABLE``
+ *
+ * .. warning:: This API has been marked as unstable: it works as advertised, but it may be changed in a future release.
  */
 typedef enum { Z_RELIABILITY_BEST_EFFORT = 1, Z_RELIABILITY_RELIABLE = 0 } z_reliability_t;
 #define Z_RELIABILITY_DEFAULT Z_RELIABILITY_RELIABLE

include/zenoh-pico/api/primitives.h

@@ -1413,6 +1413,8 @@ z_sample_kind_t z_sample_kind(const z_loaned_sample_t *sample);
  *
  * Return:
  *   The reliability wrapped as a :c:type:`z_reliability_t`.
+ *
+ * .. warning:: This API has been marked as unstable: it works as advertised, but it may be changed in a future release.
  */
 z_reliability_t z_sample_reliability(const z_loaned_sample_t *sample);
 #endif
@@ -2130,6 +2132,8 @@ z_result_t zp_send_join(const z_loaned_session_t *zs, const zp_send_join_options
  *
  * Return:
  *   The reliability wrapped as a :c:type:`z_reliability_t`.
+ *
+ * .. warning:: This API has been marked as unstable: it works as advertised, but it may be changed in a future release.
  */
 z_reliability_t z_reliability_default(void);
 #endif