chore: discourage go install, update links

Signed-off-by: Todd Baert <[email protected]>

Author: toddbaert

docs/installation.md

@@ -32,7 +32,12 @@ For more information, see [OpenFeature Operator](./reference/openfeature-operato
 
 :fontawesome-brands-linux::fontawesome-brands-windows::fontawesome-brands-apple: Binaries are available in x86/ARM.
 
-[Release](https://github.com/open-feature/flagd/releases)
+[Releases](https://github.com/open-feature/flagd/releases)
+
+!!! note
+
+    Installing flagd with `go install github.com/open-feature/flagd/flagd@latest` is not recommended, because the module depends on potentially unpublished, local workspace modules.
+    Please use one of the official, versioned binary releases above.
 
 ### systemd
 
@@ -44,12 +49,6 @@ A systemd wrapper is available [here](https://github.com/open-feature/flagd/blob
 brew install flagd
 ```
 
-### Go binary
-
-```shell
-go install github.com/open-feature/flagd/flagd@latest
-```
-
 ## Summary
 
 Once flagd is installed, you can start using it within your application.

docs/reference/specifications/protos.md

@@ -336,7 +336,7 @@ FetchAllFlagsResponse is the server response containing feature flag configurati
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| flag_configuration | [string](#string) |  | flagd feature flag configuration. Must be validated to schema - https://raw.githubusercontent.com/open-feature/schemas/main/json/flagd-definitions.json |
+| flag_configuration | [string](#string) |  | flagd feature flag configuration. Must be validated to schema - https://raw.githubusercontent.com/open-feature/flagd-schemas/main/json/flags.json |
 
 
 
@@ -357,6 +357,7 @@ GetMetadataRequest is the request for retrieving metadata from the sync service
 
 ### GetMetadataResponse
 GetMetadataResponse contains metadata from the sync service
+DEPRECATED; use flagd.sync.v1.SyncFlagsResponse.sync_context
 
 
 | Field | Type | Label | Description |
@@ -393,7 +394,8 @@ SyncFlagsResponse is the server response containing feature flag configurations
 
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
-| flag_configuration | [string](#string) |  | flagd feature flag configuration. Must be validated to schema - https://raw.githubusercontent.com/open-feature/schemas/main/json/flagd-definitions.json |
+| flag_configuration | [string](#string) |  | flagd feature flag configuration. Must be validated to schema - https://raw.githubusercontent.com/open-feature/flagd-schemas/main/json/flags.json |
+| sync_context | [google.protobuf.Struct](#google-protobuf-Struct) | optional | Static context to be included in in-process evaluations (optional). |