diff --git a/packages/core/src/Renderer.js b/packages/core/src/Renderer.js
index d60bf55..d0648ff 100644
--- a/packages/core/src/Renderer.js
+++ b/packages/core/src/Renderer.js
@@ -89,8 +89,14 @@
          */
         this.type = RENDERER_TYPE.WEBGL;
 
-        // this will be set by the contextSystem (this.context)
+        /**
+         * WebGL context, set by the contextSystem (this.context)
+         *
+         * @readonly
+         * @member {WebGLRenderingContext}
+         */
         this.gl = null;
+
         this.CONTEXT_UID = 0;
 
         // TODO legacy!

diff --git a/packages/core/src/Renderer.js b/packages/core/src/Renderer.js
index d60bf55..d0648ff 100644
--- a/packages/core/src/Renderer.js
+++ b/packages/core/src/Renderer.js
@@ -89,8 +89,14 @@
          */
         this.type = RENDERER_TYPE.WEBGL;
 
-        // this will be set by the contextSystem (this.context)
+        /**
+         * WebGL context, set by the contextSystem (this.context)
+         *
+         * @readonly
+         * @member {WebGLRenderingContext}
+         */
         this.gl = null;
+
         this.CONTEXT_UID = 0;
 
         // TODO legacy!
diff --git a/packages/core/src/textures/resources/Resource.js b/packages/core/src/textures/resources/Resource.js
index 36b30e5..08292ca 100644
--- a/packages/core/src/textures/resources/Resource.js
+++ b/packages/core/src/textures/resources/Resource.js
@@ -106,6 +106,8 @@
 
     /**
      * Trigger a resize event
+     * @param {number} width X dimension
+     * @param {number} height Y dimension
      */
     resize(width, height)
     {

diff --git a/packages/core/src/Renderer.js b/packages/core/src/Renderer.js
index d60bf55..d0648ff 100644
--- a/packages/core/src/Renderer.js
+++ b/packages/core/src/Renderer.js
@@ -89,8 +89,14 @@
          */
         this.type = RENDERER_TYPE.WEBGL;
 
-        // this will be set by the contextSystem (this.context)
+        /**
+         * WebGL context, set by the contextSystem (this.context)
+         *
+         * @readonly
+         * @member {WebGLRenderingContext}
+         */
         this.gl = null;
+
         this.CONTEXT_UID = 0;
 
         // TODO legacy!
diff --git a/packages/core/src/textures/resources/Resource.js b/packages/core/src/textures/resources/Resource.js
index 36b30e5..08292ca 100644
--- a/packages/core/src/textures/resources/Resource.js
+++ b/packages/core/src/textures/resources/Resource.js
@@ -106,6 +106,8 @@
 
     /**
      * Trigger a resize event
+     * @param {number} width X dimension
+     * @param {number} height Y dimension
      */
     resize(width, height)
     {
diff --git a/packages/sprite/src/Sprite.js b/packages/sprite/src/Sprite.js
index bb4bcfb..a1ac4a7 100644
--- a/packages/sprite/src/Sprite.js
+++ b/packages/sprite/src/Sprite.js
@@ -129,6 +129,13 @@
          */
         this._cachedTint = 0xFFFFFF;
 
+        /**
+         * this is used to store the uvs data of the sprite, assigned at the same time
+         * as the vertexData in calculateVertices()
+         *
+         * @private
+         * @member {Float32Array}
+         */
         this.uvs = null;
 
         // call texture setter