diff --git a/src/core/README.md b/src/core/README.md
index 0f92849..e0731f3 100644
--- a/src/core/README.md
+++ b/src/core/README.md
@@ -1,7 +1,31 @@
-Changelog:
+## TODO
+- [X] Document raycaster component
+- [ ] Document new events/props on Object3D
+- [ ] Click events on Raycaster
+- [ ] Click events on Object3D
+
+## Changelog
 
 ### Raycaster component
 
+See [here](https://troisjs-instancedcolors.netlify.app/) for an example ([source](https://github.com/SaFrMo/trois-examples/blob/instanced-colors-standalone-demo/src/components/InstancedColors/InstancedColors.vue)).
+
+```html
+<Camera>
+    <!-- if the Raycaster is a child of a camera, use that camera as the ray origin -->
+    <Raycaster 
+        :onPointerOver="callback that accepts an array of all new intersections, like onMouseEnter" 
+        :onPointerLeave="callback that accepts an array of all newly-ended intersections, like onMouseLeave" 
+        :onPointerOver="callback that accepts array of all current intersections"
+
+        :onBeforeRender="callback that fires every frame - optional, accepts the created raycaster. setting this property assumes the user is implementing all raycaster functionality and nullifies all other props and built-in functionality."
+        :scene="THREE scene - optional, defaults to current scene"
+        :camera="camera - optional, defaults to parent camera"
+        :intersects="array of objects to check for intersections - optional, casts against all scene children by default"
+        />
+</Camera>
+```
+
 
 ### Deprecations
 
diff --git a/src/core/Raycaster.js b/src/core/Raycaster.js
index b6435ed..1c06d45 100644
--- a/src/core/Raycaster.js
+++ b/src/core/Raycaster.js
@@ -64,6 +64,8 @@ export default {
         this.raycasterCamera = parent.camera;
         parent = parent.$parent;
       }
+    } else {
+      this.raycasterCamera = this.camera;
     }
 
     // add event listeners