diff --git a/examples/lucene-linguistics/README.md b/examples/lucene-linguistics/README.md
index 37f4da6c5..412a38cf4 100644
--- a/examples/lucene-linguistics/README.md
+++ b/examples/lucene-linguistics/README.md
@@ -136,13 +136,9 @@ Have fun!
 
 The `lucene-linguistics` component is highly configurable.
 It has an optional `configDir` configuration parameter of type `path`.
-`configDir` is a directory to store linguistics resources, e.g. dictionaries with stopwords, etc., and is relative to the VAP root directory.
+`configDir` is a directory to store linguistics resources, e.g. dictionaries with stopwords, etc., and is relative to the application package root directory.
 
-There are several known problems that might happen when `configDir` is misconfigured.
-
-### `configDir` is specified, but doesn't exist or specified directory is empty
-
-If the `configDir` doesn't exist or is empty `vespa deploy` would fail with this error:
+If the `configDir` doesn't exist or is empty, `vespa deploy` would fail with this error:
 
 ```shell
 Uploading application package... done
@@ -151,10 +147,3 @@ Success: Triggered deployment of target/application with run ID 1
 Deployment failed: Invalid application: Invalid config in services.xml for 'com.yahoo.language.lucene.lucene-analysis': /opt/vespa/var/db/vespa/config_server/serverdb/tenants/default/sessions/8/foo (No such file or directory)
 Error: deployment run nnn incomplete after waiting up to 1m0s: aborting wait: run nnn ended with unsuccessful status: deploymentFailed
 ```
-
-### Harmless warning
-`vespa deploy` always warns with:
-```shell
-WARNING Jar file 'vespa-lucene-linguistics-poc-0.0.1-deploy.jar' uses non-public Vespa APIs: [com.yahoo.language.simple]
-```
-You can ignore this warning.
diff --git a/examples/lucene-linguistics/advanced-configuration/pom.xml b/examples/lucene-linguistics/advanced-configuration/pom.xml
index 1affd2b6a..d6745d466 100644
--- a/examples/lucene-linguistics/advanced-configuration/pom.xml
+++ b/examples/lucene-linguistics/advanced-configuration/pom.xml
@@ -28,6 +28,7 @@
       <groupId>com.yahoo.vespa</groupId>
       <artifactId>lucene-linguistics</artifactId>
       <version>${vespa_version}</version>
+      <scope>provided</scope>
     </dependency>
     <dependency>
       <groupId>com.yahoo.vespa</groupId>
diff --git a/examples/lucene-linguistics/going-crazy/pom.xml b/examples/lucene-linguistics/going-crazy/pom.xml
index 882639751..ffcf20b41 100644
--- a/examples/lucene-linguistics/going-crazy/pom.xml
+++ b/examples/lucene-linguistics/going-crazy/pom.xml
@@ -23,6 +23,7 @@
       <groupId>com.yahoo.vespa</groupId>
       <artifactId>lucene-linguistics</artifactId>
       <version>${vespa_version}</version>
+      <scope>provided</scope>
     </dependency>
     <dependency>
       <groupId>org.apache.lucene</groupId>
diff --git a/examples/lucene-linguistics/minimal/pom.xml b/examples/lucene-linguistics/minimal/pom.xml
index 559f65630..ec2274836 100644
--- a/examples/lucene-linguistics/minimal/pom.xml
+++ b/examples/lucene-linguistics/minimal/pom.xml
@@ -21,6 +21,7 @@
       <groupId>com.yahoo.vespa</groupId>
       <artifactId>lucene-linguistics</artifactId>
       <version>${vespa_version}</version>
+      <scope>provided</scope>
     </dependency>
     <dependency>
       <groupId>com.yahoo.vespa</groupId>
diff --git a/examples/lucene-linguistics/minimal/src/main/application/services.xml b/examples/lucene-linguistics/minimal/src/main/application/services.xml
index 156e0b424..0a357c7f8 100644
--- a/examples/lucene-linguistics/minimal/src/main/application/services.xml
+++ b/examples/lucene-linguistics/minimal/src/main/application/services.xml
@@ -3,8 +3,8 @@
   <container id="container" version="1.0">
     <components>
       <component id="linguistics"
-                 class="com.yahoo.language.lucene.LuceneLinguistics"
-                 bundle="lucene-linguistics-minimal">
+                 bundle="lucene-linguistics"
+                 class="com.yahoo.language.lucene.LuceneLinguistics">
         <config name="com.yahoo.language.lucene.lucene-analysis"/>
       </component>
     </components>