explained how to add examples

CONTRIBUTING.md

@@ -17,7 +17,11 @@ make lint
 **NOTE**: Should be installed with `make dev-setup`, if you prefer manually, have a look at the [installation guide](https://golangci-lint.run/welcome/install/#local-installation).
 
 
-In addition, when changing documentation, run `make gen-docs`.
+## Documentation
+
+The resource examples are generated from the schema. This means that in order to update the examples, you will need to update the `ResourceMarkdownDescription` in the resource schema.go file.
+
+In addition, when changing schema, run `make gen-docs`.
 
 You can preview how the documentation will look in the Terraform registry with [this tool](https://registry.terraform.io/tools/doc-preview).
 

port/scorecard/schema.go

@@ -258,7 +258,7 @@ resource "port_scorecard" "readiness" {
 
 ` + "```" + `
 
-## Example Usage with Levels
+## Example Usage with Levels and Filter
 
 This will override the default levels (Basic, Bronze, Silver, Gold) with the provided levels: Not Ready, Partially Ready, Ready.
 
@@ -295,6 +295,16 @@ resource "port_scorecard" "readiness" {
   identifier = "Readiness"
   title      = "Readiness"
   blueprint  = port_blueprint.microservice.identifier
+  filter = {
+    combinator = "and"
+    conditions = [
+      jsonencode({
+        property = "sum"
+        operator = ">"
+        value = 0
+      })
+    ]
+  }
   levels = [
     {
       color = "red"