Merge pull request #563 from o1-labs/experimental

docs: new experimental topic with channel to give feedback

docs/zkapps/experimental.mdx

@@ -0,0 +1,29 @@
+---
+title: Experimental features
+description: Experimental features are not considered production-ready.  
+keywords:
+  - experimental
+  - feedback
+---
+
+# Experimental features
+
+Some new features are considered experimental before they are production-ready.
+
+Exposing experimental features gives you an opportunity to try our newest features sooner.
+
+In return, your feedback helps us make sure that our new features are reliable and useful.
+
+## Feedback
+
+We appreciate any and all feedback you want to provide. 
+
+The best place to provide feedback and ask questions is on [Mina Protocol Discord](https://bit.ly/MinaDiscord). 
+
+To ask zkApps questions and engage with other developers building zkApps with SnarkyJS, use the [#zkapps-developers](https://discord.com/channels/484437221055922177/915745847692636181) channel.
+
+Experimental features are in active development and your feedback is especially appreciated.
+
+- The feature may have bugs
+- The feature may be changed, deprecated, or removed
+- Any documentation for the feature explicitly notes the feature is experimental

docs/zkapps/snarkyjs/recursion.mdx

@@ -20,9 +20,9 @@ zkApp programmability is not yet available on the Mina Mainnet. You can get star
 
 :::
 
-Experimental. This API may change.
+[Experimental](/zkapps/experimental). This API may change.
 
-Specifically, we are looking into refactoring ZkProgram methods to explicitly return values rather than requiring them to be passed as further inputs.
+Specifically, ZkProgram methods could be refactored to explicitly return values rather than requiring them to be passed as further inputs.
 
 # Recursion
 

docs/zkapps/snarkyjs/smart-contracts.md

@@ -20,9 +20,9 @@ keywords:
 
 :::info
 
-Experimental. This API may change.
+[Experimental](/zkapps/experimental). This API may change.
 
-Specifically, we are looking into refactoring ZkProgram methods to explicitly return values rather than requiring them to be passed as further inputs.
+Specifically, ZkProgram methods could be refactored to explicitly return values rather than requiring them to be passed as further inputs.
 
 :::
 

sidebars.js

@@ -330,6 +330,7 @@ module.exports = {
         },
         'zkapps/roadmap',
         'zkapps/faq',
+        'zkapps/experimental',    
         'zkapps/zkapps-for-ethereum-developers',
       ],
     },