Add pages to provide feedback on Declarative Gradle

oleg-nenashev · oleg-nenashev · commit d5f56bc7246f · 2024-08-29T14:33:40.000+02:00
diff --git a/README.md b/README.md
@@ -10,14 +10,27 @@ We are working on _Declarative Gradle_ to realize that part of the vision.
 This is an experimental project, stay tuned for updates!
 
 Learn more in the [Declarative Gradle Announcement](https://blog.gradle.org/declarative-gradle)
-blog post and [other publications](./publications/README.md).
+blog post and [other publications](./docs/publications/README.md).
 
-!!! info
-    _Declarative Gradle_ is an **experimental** project.
-    Currently, no compatibility is guaranteed, and there is no commitment to the DSL syntax
-    and available features.
+## Status
 
-    Learn how you can contribute in the [Participate](./docs/CONTRIBUTING.md) section.
+_Declarative Gradle_ is an **experimental** project, now in [Early Access Preview (EAP)](./docs/EAP.md).
+We invite you to [try out Declarative Gradle](./docs/getting-started/README.md),
+and to [share feedback](./docs/feedback.md).
+The project includes the following experimental parts:
+
+- Changes in Gradle to support DCL files
+- Changes in Android Studio to support DCL files
+- Prototype plugins demonstrating software types and higher-level models
+- A Gradle test client demonstrating features not yet implemented in the IDE
+
+Currently, no compatibility is guaranteed, and there is no commitment to the DSL syntax
+and available features.
+Learn how you can contribute in the [Participate](./docs/CONTRIBUTING.md) section.
+
+<a class="button button--blue" href="./docs/feedback">
+   Share Your Feedback
+</a>
 
 ## Key Principles
 
@@ -64,4 +77,9 @@ The _Declarative Gradle_ experiment is still in an early stage but is ready for
 * [Getting Started](docs/getting-started/README.md) - Learn how to try _Declarative Gradle_ yourself.
 * [Documentation](docs/reference/README.md) - Learn about the fundamentals behind _Declarative Gradle_.
 * [Participate](docs/CONTRIBUTING.md) - Learn how you can help shape the future of _Declarative Gradle_.
-* [Resources](publications/README.md) - Learn more from conferences, interviews, articles, etc.
+* [Resources](docs/publications/README.md) - Learn more from conferences, interviews, articles, etc.
+
+## Share Feedback
+
+We invite you to [try out Declarative Gradle](./docs/getting-started/README.md),
+and to [share your feedback](./docs/feedback.md).
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
@@ -10,8 +10,9 @@ Discussion and sharing feedback is the recommended way of participation at the m
 ## Share Feedback
 
 While the project is in early stages,
-initial feedback on DSL and use-cases will be appreciated!
+initial feedback on the DSL, early demos, features and use-cases will be appreciated!
 
+- Fill out the [Feedback Form](./feedback.md)
 - `#declarative-gradle` channel on the [Gradle Community Slack](https://gradle.org/slack-invite)
 
 ## Adopting Declarative Gradle in your projects
diff --git a/docs/EAP.md b/docs/EAP.md
@@ -0,0 +1,6 @@
+# Declarative Gradle - Early Access Preview
+
+!!! info
+
+    In July 2024, we announced the first early access preview (EAP) of Declarative Gradle.
+    See this [blogpost](https://blog.gradle.org/declarative-gradle-first-eap) for the current status.
diff --git a/docs/assets/css/gradle.css b/docs/assets/css/gradle.css
@@ -16,6 +16,7 @@
 
 .md-banner {
     div {
+        font-size: large;
         text-align: center;
         a {
             color: var(--gradle-blue);
diff --git a/docs/feedback.md b/docs/feedback.md
@@ -0,0 +1,16 @@
+# Declarative Gradle - Share Feedback
+
+While Declarative Gradle is in early stages, you can explore the project samples and some of the features.
+Check out the [Getting Started Guide](./getting-started/README.md) tfor the pointer.
+Initial feedback on the DSL, early demos, features and use-cases will be appreciated!
+
+## Feedback Form
+
+If the form below does not load,
+use [this link](https://docs.google.com/forms/d/e/1FAIpQLSdA8uHyZYSIAlzgg-Hxj60_Qv5LgvNKr01NDAiv4ZoxpX5YRA/viewform)
+
+<iframe src="https://docs.google.com/forms/d/e/1FAIpQLSdA8uHyZYSIAlzgg-Hxj60_Qv5LgvNKr01NDAiv4ZoxpX5YRA/viewform?embedded=true" width="100%" height="2345" frameborder="0" marginheight="0" marginwidth="0">Loading…</iframe>
+
+## Other Feedback Channels
+
+- `#declarative-gradle` channel on the [Gradle Community Slack](https://gradle.org/slack-invite)
diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md
@@ -3,6 +3,9 @@
 In our first [announcement](https://blog.gradle.org/declarative-gradle), we introduced our ideas for an experimental project we called Declarative Gradle. 
 
 Since then, we've been working hard on several fronts to create the first early access preview (EAP) for Declarative Gradle.
+In July 2024, we [announced the Early Access Preview (EAP)](./../EAP.md) of Declarative Gradle.
+As part of this preview, we published several project samples that are ready for feedback.
+These include Java, Kotlin, and Android application samples and a port of the popular Now in Android application.
 
 !!! info
     With the first EAP, we would like you to try out what we have built so far.
diff --git a/docs/publications/2024-05-kotlinconf.md b/docs/publications/2024-05-kotlinconf.md
diff --git a/docs/publications/README.md b/docs/publications/README.md
diff --git a/docs/theme/main.html b/docs/theme/main.html
@@ -1,8 +1,9 @@
 {% extends "base.html" %}
 
 {% block announce %}
-  Want to have better developer experience whith Gradle?
-  We need your help, take the <a href="./surveys/developer-survey/">Gradle Developer Survey</a>!
+  Declarative Gradle is now in Early Access Preview (EAP), and we need your feedback!
+  <a href="https://declarative.gradle.org/docs/getting-started/">Try it out</a>
+  and <a href="https://declarative.gradle.org/docs/feedback/">share your experiences</a>.
 {% endblock %}
 
 {% block scripts %}
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -93,11 +93,12 @@ nav:
     - Overview: docs/reference/README.md
     - Roadmap: docs/ROADMAP.md
     - Software Features: docs/reference/software-features.md
-  - Participate:
+  - Resources:
+    - Publications: docs/publications/README.md
     - Contributing: docs/CONTRIBUTING.md
+    - Feedback Form: docs/feedback.md
     - Code of Conduct: docs/CODE_OF_CONDUCT.md
-  - Resources:
-    - Publications: publications/README.md
+  - Share Feedback: docs/feedback.md
 
 extra_css:
   - docs/assets/css/gradle.css
@@ -143,6 +144,8 @@ plugins:
         'docs/kotlin/README.md': 'docs/getting-started/samples.md#kotlin-application'
         'docs/swift/README.md': 'docs/getting-started/samples.md#swift'
         'unified-prototype/README.md': 'docs/getting-started/samples.md#prototypes'
+        'docs/EAP.md': https://blog.gradle.org/declarative-gradle-first-eap
+        'publications/README.md': docs/publications/README.md
 
 # Markdown
 markdown_extensions:
