add providers to docs

Signed-off-by: Michael Beemer <beeme1mr@users.noreply.github.com>

.gitignore

@@ -13,6 +13,7 @@ go.work
 go.work.sum
 bin/
 node_modules/
+.venv
 
 # built documentation
 site

Dockerfile

@@ -1,2 +1,2 @@
-FROM squidfunk/mkdocs-material
+FROM squidfunk/mkdocs-material:9.5
 RUN pip install mkdocs-include-markdown-plugin

docs/installation.md

@@ -18,7 +18,7 @@ docker pull ghcr.io/open-feature/flagd:latest
 FROM ghcr.io/open-feature/flagd:latest
 ```
 
-### Kubernetes
+## Kubernetes
 
 flagd was designed with cloud-native paradigms in mind.
 You can run it as a sidecar, or as a central service in your cluster.
@@ -49,19 +49,3 @@ brew install flagd
 ```shell
 go install github.com/open-feature/flagd/flagd@latest
 ```
-
----
-
-## flagd Providers for OpenFeature
-
-Leverage flagd in your application using [OpenFeature](https://openfeature.dev/) and a flagd [provider](https://openfeature.dev/docs/reference/concepts/provider).
-Use the table below to see what provides are available.
-
-| Technology                                                    | RPC              | in-process       |
-| ------------------------------------------------------------- | ---------------- | ---------------- |
-| :fontawesome-brands-golang: [Go](./providers/go.md)           | :material-check: | :material-check: |
-| :fontawesome-brands-java: [Java](./providers/java.md)         | :material-check: | :material-check: |
-| :fontawesome-brands-node-js: [Node.JS](./providers/nodejs.md) | :material-check: | :material-check: |
-| :simple-php: [PHP](./providers/php.md)                        | :material-check: | :material-close: |
-| :simple-dotnet: [.NET](./providers/dotnet.md)                 | :material-check: | :material-close: |
-| :material-web: [Web](./providers/web.md)                      | :material-check: | :material-close: |

docs/providers/dotnet.md

@@ -1,4 +1,3 @@
-
 # .NET provider
 
 ## Installation

docs/providers/go.md

@@ -1,13 +1,9 @@
-
 # Go provider
 
-{%
-  include "https://raw.githubusercontent.com/open-feature/go-sdk-contrib/main/providers/flagd/README.md"
-  start="## Setup"
-  end="## License"
-%}
+## Installation
 
 {%
-  include "https://raw.githubusercontent.com/open-feature/go-sdk-contrib/main/providers/flagd-in-process/README.md"
+  include "https://raw.githubusercontent.com/open-feature/go-sdk-contrib/main/providers/flagd/README.md"
+  start="## Installation"
   end="## License"
 %}

docs/providers/index.md

@@ -0,0 +1,25 @@
+---
+title: OpenFeature Providers
+description: Overview of the available flagd providers compatible with OpenFeature.
+---
+
+flagd was built from the ground up to be [Openfeature-compliant](../concepts/feature-flagging.md#openfeature-compliance).
+To use it in your application, you must use the [OpenFeature SDK](https://openfeature.dev/docs/reference/technologies/) for your language, along with the associated OpenFeature _provider_.
+For more information about Openfeature providers, see the [OpenFeature documentation](https://openfeature.dev/docs/reference/concepts/provider).
+
+## Providers
+
+Providers for flagd come in two flavors: those that are built to communicate with a flagd instance (over HTTP or gRPC) and those that embed flagd's evaluation engine directly (note that some providers are capable of operating in either mode). For more information on how to deploy and use flagd, see [architecture](../architecture.md) and [installation](../installation.md).
+
+The following table lists all the available flagd providers.
+
+| Technology                                                    | RPC              | in-process       |
+| ------------------------------------------------------------- | ---------------- | ---------------- |
+| :fontawesome-brands-golang: [Go](./go.md)           | :material-check: | :material-check: |
+| :fontawesome-brands-java: [Java](./java.md)         | :material-check: | :material-check: |
+| :fontawesome-brands-node-js: [Node.JS](./nodejs.md) | :material-check: | :material-check: |
+| :simple-php: [PHP](./php.md)                        | :material-check: | :material-close: |
+| :simple-dotnet: [.NET](./dotnet.md)                 | :material-check: | :material-close: |
+| :material-web: [Web](./web.md)                      | :material-check: | :material-close: |
+
+For information on implementing a flagd provider, see the specifications for [RPC](../reference/specifications/rpc-providers.md) and [in-process](../reference/specifications/in-process-providers.md) providers.

docs/providers/java.md

@@ -1,4 +1,3 @@
-
 # Java provider
 
 ## Installation

docs/providers/nodejs.md

@@ -1,4 +1,3 @@
-
 # Node.js provider
 
 ## Installation

docs/providers/php.md

@@ -1,4 +1,3 @@
-
 # PHP provider
 
 ## Installation

docs/reference/specifications/rpc-providers.md

@@ -1,5 +1,5 @@
 ---
-description: flagd RPC proivider specification
+description: flagd RPC provider specification
 ---
 
 # Creating an RPC flagd provider
@@ -12,7 +12,7 @@ as it is done in the [OpenFeature Operator](https://github.com/open-feature/open
 Prerequisites:
 
 - Understanding of [general provider concepts](https://openfeature.dev/docs/reference/concepts/provider/)
-- Proficiency in the chosen programming language (check the language isn't already covered by the [existing providers](../providers.md))
+- Proficiency in the chosen programming language (check the language isn't already covered by the [existing providers](../../providers/index.md))
 
 ## flagd Evaluation API
 

mkdocs.yml

@@ -31,6 +31,10 @@ theme:
     - search.suggest
     - search.highlight
     - search.share
+    - content.tooltips
+    - navigation.instant
+    - navigation.tracking
+    - navigation.indexes
 extra_css:
   - assets/extra.css
 
@@ -58,9 +62,8 @@ markdown_extensions:
   - attr_list
   - md_in_html
   - pymdownx.emoji:
-      # we are using an older emoji extension because the newest (suggested in docs) doesn't work with Python < 3.10
-      emoji_index: !!python/name:materialx.emoji.twemoji
-      emoji_generator: !!python/name:materialx.emoji.to_svg
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
 
 nav:
   - 'Introduction': 'index.md'
@@ -71,7 +74,8 @@ nav:
     - 'Feature Flagging': 'concepts/feature-flagging.md'
     - 'Syncs': 'concepts/syncs.md'
   - 'Architecture': 'architecture.md'
-  - 'Providers':
+  - 'OpenFeature Providers':
+    - 'providers/index.md'
     - 'Go': 'providers/go.md'
     - 'Java': 'providers/java.md'
     - 'Node.JS': 'providers/nodejs.md'
@@ -90,7 +94,6 @@ nav:
         - 'Fractional': 'reference/custom-operations/fractional-operation.md'
         - 'Semantic Version': 'reference/custom-operations/semver-operation.md'
         - 'String Comparison': 'reference/custom-operations/string-comparison-operation.md'
-    - 'Providers': 'reference/providers.md'
     - 'Monitoring': 'reference/monitoring.md'
     - 'Specifications':
       - 'RPC Providers': 'reference/specifications/rpc-providers.md'
@@ -112,3 +115,7 @@ plugins:
   - search
   # https://github.com/mondeja/mkdocs-include-markdown-plugin
   - include-markdown
+  # https://github.com/mkdocs/mkdocs-redirects
+  - redirects:
+      redirect_maps:
+        'reference/providers.md': 'providers/index.md'