From 245fe386b65ff505569b88745a594f2fc1b8312d Mon Sep 17 00:00:00 2001 From: cheddar Date: Fri, 4 Nov 2016 10:53:21 -0700 Subject: [PATCH 1/3] Call out semver expectations for modules --- docs/content/development/modules.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/development/modules.md b/docs/content/development/modules.md index d79133bc1aa8..08be4936143f 100644 --- a/docs/content/development/modules.md +++ b/docs/content/development/modules.md @@ -8,7 +8,7 @@ Druid uses a module system that allows for the addition of extensions at runtime ## Writing your own extensions -Druid's extensions leverage Guice in order to add things at runtime. Basically, Guice is a framework for Dependency Injection, but we use it to hold the expected object graph of the Druid process. Extensions can make any changes they want/need to the object graph via adding Guice bindings. While the extensions actually give you the capability to change almost anything however you want, in general, we expect people to want to extend one of a few things. +Druid's extensions leverage Guice in order to add things at runtime. Basically, Guice is a framework for Dependency Injection, but we use it to hold the expected object graph of the Druid process. Extensions can make any changes they want/need to the object graph via adding Guice bindings. While the extensions actually give you the capability to change almost anything however you want, in general, we expect people to want to extend one of the things listed below. This means that we honor semantic versioning for changes that affect the interfaces called out on this page, but other interfaces are deemed "internal" anad can be changed in an incompatible manner even between patch releases. 1. Add a new deep storage implementation 1. Add a new Firehose From af7540d5f2452d8e69acbab5c30d1ef6aeea4866 Mon Sep 17 00:00:00 2001 From: cheddar Date: Fri, 4 Nov 2016 11:31:48 -0700 Subject: [PATCH 2/3] Update modules.md --- docs/content/development/modules.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/development/modules.md b/docs/content/development/modules.md index 08be4936143f..f4b2d9ba6e4c 100644 --- a/docs/content/development/modules.md +++ b/docs/content/development/modules.md @@ -8,7 +8,7 @@ Druid uses a module system that allows for the addition of extensions at runtime ## Writing your own extensions -Druid's extensions leverage Guice in order to add things at runtime. Basically, Guice is a framework for Dependency Injection, but we use it to hold the expected object graph of the Druid process. Extensions can make any changes they want/need to the object graph via adding Guice bindings. While the extensions actually give you the capability to change almost anything however you want, in general, we expect people to want to extend one of the things listed below. This means that we honor semantic versioning for changes that affect the interfaces called out on this page, but other interfaces are deemed "internal" anad can be changed in an incompatible manner even between patch releases. +Druid's extensions leverage Guice in order to add things at runtime. Basically, Guice is a framework for Dependency Injection, but we use it to hold the expected object graph of the Druid process. Extensions can make any changes they want/need to the object graph via adding Guice bindings. While the extensions actually give you the capability to change almost anything however you want, in general, we expect people to want to extend one of the things listed below. This means that we honor semantic versioning for changes that affect the interfaces called out on this page, but other interfaces are deemed "internal" and can be changed in an incompatible manner even between patch releases. 1. Add a new deep storage implementation 1. Add a new Firehose From c5c4bc4f80497d88b1529a9ddcd897f464a6855d Mon Sep 17 00:00:00 2001 From: cheddar Date: Fri, 4 Nov 2016 11:37:52 -0700 Subject: [PATCH 3/3] Link to versioning --- docs/content/development/modules.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/development/modules.md b/docs/content/development/modules.md index f4b2d9ba6e4c..934277b02f9d 100644 --- a/docs/content/development/modules.md +++ b/docs/content/development/modules.md @@ -8,7 +8,7 @@ Druid uses a module system that allows for the addition of extensions at runtime ## Writing your own extensions -Druid's extensions leverage Guice in order to add things at runtime. Basically, Guice is a framework for Dependency Injection, but we use it to hold the expected object graph of the Druid process. Extensions can make any changes they want/need to the object graph via adding Guice bindings. While the extensions actually give you the capability to change almost anything however you want, in general, we expect people to want to extend one of the things listed below. This means that we honor semantic versioning for changes that affect the interfaces called out on this page, but other interfaces are deemed "internal" and can be changed in an incompatible manner even between patch releases. +Druid's extensions leverage Guice in order to add things at runtime. Basically, Guice is a framework for Dependency Injection, but we use it to hold the expected object graph of the Druid process. Extensions can make any changes they want/need to the object graph via adding Guice bindings. While the extensions actually give you the capability to change almost anything however you want, in general, we expect people to want to extend one of the things listed below. This means that we honor our [versioning strategy](./versioning.html) for changes that affect the interfaces called out on this page, but other interfaces are deemed "internal" and can be changed in an incompatible manner even between patch releases. 1. Add a new deep storage implementation 1. Add a new Firehose