Merge branch 'main' into json-config

ROADMAP.md

@@ -1,6 +1,6 @@
 # 🔮 Apollo Kotlin Roadmap
 
-**Last updated: 2023-12-21**
+**Last updated: 2024-01-11**
 
 For up to date release notes, refer to the project [Changelog](https://github.com/apollographql/apollo-kotlin/blob/main/CHANGELOG.md).
 
@@ -19,11 +19,11 @@ For up to date release notes, refer to the project [Changelog](https://github.co
 
 ## [4.0](https://github.com/apollographql/apollo-kotlin/milestone/29)
 
-_Approximate GA Date: January 2024 (GA)_
+_Approximate GA Date: February 2024 (GA)_
 
 Our next major release is currently in the beta stage. Expect new beta to be released as we make progress towards a GA release candidate. This major version removes some deprecated APIs but will otherwise contain mostly incremental changes and most of the API will stay compatible.  We are hoping to do a GA release after Kotlin 2.0.0 is generally available.
 
-Here's a high-level overview of what to expect:
+Here's a high-level overview of the feature set:
 
 - [IntelliJ / Android Studio plugin](https://github.com/apollographql/apollo-kotlin/issues?q=is%3Aissue+is%3Aopen+plugin+label%3A%22%F0%9F%90%99+IJ%2FAS+plugin%22)
 - [Java runtime](https://github.com/apollographql/apollo-kotlin/milestone/25)
@@ -39,7 +39,7 @@ Here's a high-level overview of what to expect:
 
 _This is currently available as an experimental feature.  We will release a stable version after getting sufficient user feedback_
 
-[Jetpack Compose](https://developer.android.com/jetpack/compose) is a declarative UI framework for building Android UIs written in Kotlin.  We are experimenting with a few different approaches for supporting Compose in the Apollo Kotlin library.  Our 3.8.0 release contains an experimental API for use with Compose, please do try it out and give us feedback!
+[Jetpack Compose](https://developer.android.com/jetpack/compose) is a declarative UI framework for building Android UIs written in Kotlin.  We are experimenting with a few different approaches for supporting Compose in the Apollo Kotlin library.  Our 3.8.0 release introduced an experimental API for use with Compose, please do try it out and give us feedback!
 
 ## Cache improvements
 

docs/source/testing/android-studio-plugin.mdx

@@ -25,11 +25,15 @@ This means you don't need to manually run `./gradlew generateApolloSources` afte
 
 Note: this works by running Gradle in continuous mode, and can be disabled in the plugin settings.
 
+<WistiaEmbed videoId="nf10iaupuj"/>
+
 ### Integration with the GraphQL IntelliJ Plugin
 
 The plugin depends on and integrates with the [GraphQL IntelliJ Plugin](https://plugins.jetbrains.com/plugin/8097-js-graphql).
 The file structure of the Apollo project is automatically contributed, so there is no need to create a `graphql.config.yml` / `.graphqlconfig` file.
 
+<WistiaEmbed videoId="fp8zqezcty"/>
+
 ### Navigation
 
 #### Kotlin → GraphQL
@@ -39,14 +43,20 @@ Clicking on them will navigate to the corresponding GraphQL definition.
 
 You can also go to the GraphQL definition with <kbd>Cmd</kbd> Click (Mac) or <kbd>Ctrl</kbd> Click (Windows / Linux) on an operation, field, enum, etc.
 
+<WistiaEmbed videoId="7eflcnw1zc"/>
+
 #### GraphQL → Kotlin
 
 You can search for code usages of a GraphQL operation, fragment, enum type/value and input type/field, with right click | <kbd>Find Usages</kbd>.
 
+<WistiaEmbed videoId="7wp1odktye"/>
+
 ### Unused operations / fields
 
 In GraphQL files, operations and fields are shown in grey if the corresponding generated code is not used in your project.
 
+<WistiaEmbed videoId="s6yhssdpb4"/>
+
 ### Migration helpers
 
 In the <kbd>Refactor</kbd> | <kbd>Apollo</kbd> menu, you can find helpers to migrate your project:
@@ -58,6 +68,8 @@ In the <kbd>Refactor</kbd> | <kbd>Apollo</kbd> menu, you can find helpers to mig
 Note: while these helpers will automatically update your code when possible, there are some cases where this isn't possible and manual changes are required.
 Please refer to the migration guides ([3.x](../migration/3.0/), [4.x](../migration/4.0/)) when upgrading.
 
+<WistiaEmbed videoId="utkyl1uypx"/>
+
 ### Download schema
 
 Download the latest version of your schema(s) by going to <kbd>Tools</kbd> | <kbd>Apollo</kbd> | <kbd>Download schema</kbd>.
@@ -96,7 +108,7 @@ You can also either drag and drop a `.db` file to the tool window to open it, or
 
 Once the cache is open, you can search for a record by ID, or browse them from the left side. Clicking on a record will show its fields and their values on the right side.
 
-<img src="images/cache-viewer.png" width="640" alt="Normalized cache viewer"/>
+<WistiaEmbed videoId="5dyx4qu9ue"/>
 
 ## Weekly snapshots