diff --git a/docs/resources/family_identity.md b/docs/resources/family_identity.md
index 1301075..8fe89f0 100644
--- a/docs/resources/family_identity.md
+++ b/docs/resources/family_identity.md
@@ -4,12 +4,18 @@ page_title: "tor_family_identity Resource - tor"
 subcategory: ""
 description: |-
   Generates a Tor family identity key as described in proposal 321 (Happy Families).
+  References
+  https://community.torproject.org/relay/setup/post-install/family-ids/https://gitlab.torproject.org/tpo/core/torspec/-/blob/main/proposals/321-happy-families.md
 ---
 
 # tor_family_identity (Resource)
 
 Generates a Tor family identity key as described in proposal 321 (Happy Families).
 
+### References
+- https://community.torproject.org/relay/setup/post-install/family-ids/
+- https://gitlab.torproject.org/tpo/core/torspec/-/blob/main/proposals/321-happy-families.md
+
 ## Example Usage
 
 ```terraform
@@ -17,16 +23,19 @@ resource "tor_family_identity" "example" {
   family_name = "MyFamily"
 }
 
-# Access the generated family identity
-output "family_id" {
-  value = tor_family_identity.example.id
-}
 
-# Use the secret key to configure your Tor relay
 resource "local_sensitive_file" "family_key" {
   content_base64 = tor_family_identity.example.secret_key
   filename       = "MyFamily.secret_family_key"
 }
+
+resource "local_file" "torrc" {
+  filename = "./torrc"
+  content  = <<EOF
+FamilyId ${tor_family_identity.example.id}
+... other torrc configuration ...
+EOF
+}
 ```
 
 <!-- schema generated by tfplugindocs -->
diff --git a/examples/resources/tor_family_identity/resource.tf b/examples/resources/tor_family_identity/resource.tf
index fa4b1dd..3bccb40 100644
--- a/examples/resources/tor_family_identity/resource.tf
+++ b/examples/resources/tor_family_identity/resource.tf
@@ -2,13 +2,16 @@ resource "tor_family_identity" "example" {
   family_name = "MyFamily"
 }
 
-# Access the generated family identity
-output "family_id" {
-  value = tor_family_identity.example.id
-}
 
-# Use the secret key to configure your Tor relay
 resource "local_sensitive_file" "family_key" {
   content_base64 = tor_family_identity.example.secret_key
   filename       = "MyFamily.secret_family_key"
 }
+
+resource "local_file" "torrc" {
+  filename = "./torrc"
+  content  = <<EOF
+FamilyId ${tor_family_identity.example.id}
+... other torrc configuration ...
+EOF
+}
diff --git a/internal/provider/tor_family_identity_resource.go b/internal/provider/tor_family_identity_resource.go
index f68bbd7..ac58883 100644
--- a/internal/provider/tor_family_identity_resource.go
+++ b/internal/provider/tor_family_identity_resource.go
@@ -39,7 +39,12 @@ func (r *TorFamilyIdentityResource) Metadata(ctx context.Context, req resource.M
 
 func (r *TorFamilyIdentityResource) Schema(ctx context.Context, req resource.SchemaRequest, resp *resource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "Generates a Tor family identity key as described in proposal 321 (Happy Families).",
+		MarkdownDescription: `Generates a Tor family identity key as described in proposal 321 (Happy Families).
+
+### References
+- https://community.torproject.org/relay/setup/post-install/family-ids/
+- https://gitlab.torproject.org/tpo/core/torspec/-/blob/main/proposals/321-happy-families.md
+		`,
 
 		Attributes: map[string]schema.Attribute{
 			"id": schema.StringAttribute{