chore: discourage go install, update links (#1817)

- Discourages use of `go install` (see note in PR)
- fixes some links

---------

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

Author: toddbaert

Makefile

@@ -119,10 +119,10 @@ MDL_CMD := docker run -v $(ROOT_DIR):/workdir --rm
 
 .PHONY: markdownlint markdownlint-fix
 markdownlint:
-	$(MDL_CMD) davidanson/markdownlint-cli2-rules:$(MDL_DOCKER_VERSION) "**/*.md" 
+	$(MDL_CMD) davidanson/markdownlint-cli2:$(MDL_DOCKER_VERSION) "**/*.md" 
 
 markdownlint-fix:
-	$(MDL_CMD) --entrypoint="markdownlint-cli2-fix" davidanson/markdownlint-cli2-rules:$(MDL_DOCKER_VERSION) "**/*.md"
+	$(MDL_CMD) davidanson/markdownlint-cli2:$(MDL_DOCKER_VERSION) --fix "**/*.md" 
 
 .PHONY: pull-schemas-submodule
 pull-schemas-submodule:

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). |
 
 
 

docs/reference/sync-configuration.md

@@ -11,16 +11,16 @@ See [syncs](../concepts/syncs.md) for a conceptual overview.
 Any URI passed to flagd via the `--uri` (`-f`) flag must follow one of the 6 following patterns with prefixes to ensure that
 it is passed to the correct implementation:
 
-| Implied Sync Provider | Prefix                 | Example                               |
-| --------------------- | ---------------------- | ------------------------------------- |
-| `kubernetes`          | `core.openfeature.dev` | `core.openfeature.dev/default/my-crd` |
-| `file`                | `file:`                | `file:etc/flagd/my-flags.json`        |
-| `http`                | `http(s)://`           | `https://my-flags.com/flags`          |
-| `grpc`                | `grpc(s)://`           | `grpc://my-flags-server`              |
+| Implied Sync Provider                 | Prefix                             | Example                               |
+| ------------------------------------- | ---------------------------------- | ------------------------------------- |
+| `kubernetes`                          | `core.openfeature.dev`             | `core.openfeature.dev/default/my-crd` |
+| `file`                                | `file:`                            | `file:etc/flagd/my-flags.json`        |
+| `http`                                | `http(s)://`                       | `https://my-flags.com/flags`          |
+| `grpc`                                | `grpc(s)://`                       | `grpc://my-flags-server`              |
 |  [grpc](#custom-grpc-target-uri) | `[ envoy \| dns \| uds\| xds ]://` | `envoy://localhost:9211/test.service` |
-| `gcs`                 | `gs://`                | `gs://my-bucket/my-flags.json`        |
-| `azblob`              | `azblob://`            | `azblob://my-container/my-flags.json` |
-| `s3`                  | `s3://`                | `s3://my-bucket/my-flags.json`        |
+| `gcs`                                 | `gs://`                            | `gs://my-bucket/my-flags.json`        |
+| `azblob`                              | `azblob://`                        | `azblob://my-container/my-flags.json` |
+| `s3`                                  | `s3://`                            | `s3://my-bucket/my-flags.json`        |
 
 ### Data Serialization
 
@@ -58,7 +58,7 @@ Alternatively, these configurations can be passed to flagd via config file, spec
 | providerID  | optional `string`  | Value binds to grpc connection's providerID field. gRPC server implementations may use this to identify connecting flagd instance                                                                                |
 | selector    | optional `string`  | Value binds to grpc connection's selector field. gRPC server implementations may use this to filter flag configurations                                                                                          |
 | certPath    | optional `string`  | Used for grpcs sync when TLS certificate is needed. If not provided, system certificates will be used for TLS connection                                                                                         |
-| maxMsgSize  | optional `int`     | Used for gRPC sync to set max receive message size (in bytes) e.g. 5242880 for 5MB. If not provided, the default is [4MB](https://pkg.go.dev/google.golang.org#grpc#MaxCallRecvMsgSize)                       |
+| maxMsgSize  | optional `int`     | Used for gRPC sync to set max receive message size (in bytes) e.g. 5242880 for 5MB. If not provided, the default is [4MB](https://pkg.go.dev/google.golang.org#grpc#MaxCallRecvMsgSize)                          |
 
 The `uri` field values **do not** follow the [URI patterns](#uri-patterns). The provider type is instead derived
 from the `provider` field. Only exception is the remote provider where `http(s)://` is expected by default. Incorrect