@newrelic/video-videojs 4.0.3 → 4.1.1

package/CHANGELOG.md

@@ -1,13 +1,57 @@
-## [4.0.3](https://github.com/newrelic/video-videojs-js/compare/v4.0.2...v4.0.3) (2025-11-21)
+## [4.1.1](https://github.com/newrelic/video-videojs-js/compare/v4.1.0...v4.1.1) (2026-04-17)
+
+### Documentation
+
+- **README.md:** Added Best Practices section (contentTitle, userId, custom attributes, gradual rollout with feature flags)
+- **README.md:** Promoted Bitrate Metrics to top-level section with detailed table format and NRQL query examples
+- **README.md:** Updated Data Model event descriptions to include heartbeats and media errors
+- **README.md:** Fixed DATAMODEL.md link casing
+- **README.md:** Updated Table of Contents with new sections (Prerequisites, Best Practices, Bitrate Metrics)
+- **README.md:** Renamed Contributing to Contribute for consistency across trackers
+
+## [4.1.0](https://github.com/newrelic/video-videojs-js/compare/v4.0.3...v4.1.0) (2026-04-08)
+
+### Breaking Changes
+
+- **Method Renames:** Bitrate methods renamed for clarity
+  - `getMeasuredBitrate()` → `getSegmentDownloadBitrate()` - ABR bandwidth estimate from player stats
+  - `getDownloadBitrate()` → `getNetworkDownloadBitrate()` - Instantaneous network throughput
+  - **Note:** Most users won't be affected as these methods are primarily used internally by the tracker
+
+### Deprecated
+
+- **Removed `getRenditionBitrate()` method** - No longer needed with improved bitrate tracking system
 
+### Enhancements
+
+- **Bitrate Metrics Refactoring:**
+  - Implemented consistent fallback pattern across all bitrate methods (VHS direct access → tech wrapper fallback)
+  - Simplified network download bitrate to use direct throughput access
+  - Enhanced bitrate tracking with four distinct metrics for comprehensive quality analysis
+  - Updated all tech wrappers (VHS, hls.js, Shaka) with consistent implementations
+
+- **Comprehensive Documentation Rewrite:**
+  - **README.md:** Complete rewrite with professional structure, badges, features section, table of contents, two installation options, expanded API reference, and clear New Relic support channels
+  - **datamodel.md:** Complete rewrite with comprehensive event reference, all four bitrate metrics definitions, QoE attributes, complete attribute tables for all event types, and SSAI/DAI support documentation
+  - **DEVELOPING.md:** Complete development guide with setup, build instructions, project structure, testing guidelines, and release process
+  - **REVIEW.md:** NEW FILE - Code review guidelines and standards for contributors
+
+### Documentation
+
+- Added clear instructions to obtain configuration from [one.newrelic.com](https://one.newrelic.com)
+- Updated all bitrate metric definitions with accurate sources and use cases
+- Added comprehensive API reference with method signatures and examples
+- Enhanced support section with multiple New Relic support channels
+- Added third-party library license disclosure
+
+## [4.0.3](https://github.com/newrelic/video-videojs-js/compare/v4.0.2...v4.0.3) (2025-11-21)
 
 ### Bug Fixes
 
-* removed github token ([f5f9ade](https://github.com/newrelic/video-videojs-js/commit/f5f9ade01c9af411d72ec74874f8d0750c5f0f66))
+- removed github token ([f5f9ade](https://github.com/newrelic/video-videojs-js/commit/f5f9ade01c9af411d72ec74874f8d0750c5f0f66))
 
 # CHANGELOG
 
-
 ## [4.0.2] - 2025-10-21
 
 ### Bug Fixes

package/README.md

@@ -1,131 +1,515 @@
 [![Community Project header](https://github.com/newrelic/opensource-website/raw/master/src/images/categories/Community_Project.png)](https://opensource.newrelic.com/oss-category/#community-project)
 
-# New Relic Videojs Tracker Agent
+# New Relic Video.js Tracker
 
-The New Relic Videojs Tracker enhances your media applications by tracking video events, playback errors, and other activities, providing comprehensive insights into performance and user interactions.
+[![npm version](https://badge.fury.io/js/%40newrelic%2Fvideo-videojs.svg)](https://badge.fury.io/js/%40newrelic%2Fvideo-videojs)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-- The Videojs tracker is available as a ready-to-use JavaScript snippet for easy copy-paste integration.
-- New Relic Videojs tracker auto-detects events emitted by Videojs Player.
-- Ensure that the **Browser agent** is successfully instrumented before deploying the media tracker.
-- For questions and feedback on this package, please visit the [Explorer's Hub](https://discuss.newrelic.com), New Relic's community support forum.
-- Looking to contribute to the Player Name agent code base? See [DEVELOPING.md](./DEVELOPING.md) for instructions on building and testing the browser agent library, and Contributors.
+The New Relic Video.js Tracker provides comprehensive video analytics for applications using Video.js Player. Track video events, monitor playback quality, identify errors, and gain deep insights into user engagement and streaming performance.
 
-## Adding The Videojs Tracker To Your Project
+## Features
 
-To integrate New Relic Tracker Agent into your web application effectively, you'll need to instrument the Browser Agent code first and then add the player script. Below is a guide on how to do this within your HTML file:
+- 🎯 **Automatic Event Detection** - Captures Video.js player events automatically without manual instrumentation
+- 📊 **Comprehensive Bitrate Tracking** - Four distinct bitrate metrics for complete quality analysis
+- 🎬 **Ad Tracking Support** - Full support for IMA, Freewheel, and SSAI (Server-Side Ad Insertion)
+- 🔧 **Multi-Tech Support** - Works with VHS, hls.js, and Shaka Player
+- 📈 **QoE Metrics** - Quality of Experience aggregation for startup time, buffering, and playback quality
+- 🎨 **Event Segregation** - Organized event types: `VideoAction`, `VideoAdAction`, `VideoErrorAction`, `VideoCustomAction`
+- 🚀 **Easy Integration** - NPM package or direct script include
+
+## Table of Contents
+
+- [Installation](#installation)
+  - [Option 1: NPM/Yarn](#option-1-install-via-npmyarn)
+  - [Option 2: Direct Script Include](#option-2-direct-script-include-without-npm)
+- [Prerequisites](#prerequisites)
+- [Usage](#usage)
+- [Best Practices](#best-practices)
+- [Configuration Options](#configuration-options)
+- [API Reference](#api-reference)
+- [Bitrate Metrics](#bitrate-metrics)
+- [Ad Tracking Support](#ad-tracking-support)
+- [Data Model](#data-model)
+- [Support](#support)
+- [Contribute](#contribute)
+- [License](#license)
+
+## Installation
+
+### Option 1: Install via NPM/Yarn
+
+Install the package using your preferred package manager:
+
+**NPM:**
+
+```bash
+npm install @newrelic/video-videojs
+```
+
+**Yarn:**
+
+```bash
+yarn add @newrelic/video-videojs
+```
+
+### Option 2: Direct Script Include (Without NPM)
+
+For quick integration without a build system, include the tracker directly in your HTML:
 
 ```html
 <!DOCTYPE html>
-<html lang="en">
+<html>
   <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>New Relic Tracker Integration</title>
-    <script src="path/to/browser-agent.js"></script>
-    <!-- snippet code generated  -->
-    <script src="path/to/videojs-tracker.js"></script>
+    <!-- Video.js Player -->
+    <link href="https://vjs.zencdn.net/7.20.3/video-js.css" rel="stylesheet" />
+    <script src="https://vjs.zencdn.net/7.20.3/video.js"></script>
+
+    <!-- New Relic Video.js Tracker -->
+    <script src="path/to/newrelic-video-videojs.min.js"></script>
   </head>
   <body>
-    <!-- Your HTML content -->
+    <video id="myVideo" class="video-js" controls width="640" height="480">
+      <source src="https://your-video-source.mp4" type="video/mp4" />
+    </video>
+
+    <script>
+      // Initialize Video.js player
+      var player = videojs('myVideo');
+
+      // Configure New Relic tracker with info from one.newrelic.com
+      const options = {
+        info: {
+          licenseKey: 'YOUR_LICENSE_KEY',
+          beacon: 'YOUR_BEACON_URL',
+          applicationId: 'YOUR_APP_ID',
+        },
+      };
+
+      // Initialize tracker
+      const tracker = new VideojsTracker(player, options);
+    </script>
   </body>
 </html>
 ```
 
-## Adding the agent package to your project
+**Setup Steps:**
+
+1. **Get Configuration** - Visit [one.newrelic.com](https://one.newrelic.com) and follow the Streaming Video & Ads onboarding flow to get your `licenseKey`, `beacon`, `applicationID`, and integration code snippet.
+2. **Integrate** - Include the script in your HTML and initialize with your configuration
+
+## Prerequisites
+
+Before using the tracker, ensure you have:
+
+- **New Relic Account** - Active New Relic account with valid application credentials (`beacon`, `applicationId`, `licenseKey`)
+- **Video.js Player** - Video.js player integrated in your application
+
+## Usage
+
+### Getting Your Configuration
 
-To make the tracker available to your application, install via [NPM](https://docs.npmjs.com/cli/v8/commands/npm-install) or [Yarn](https://classic.yarnpkg.com/lang/en/docs/cli/install/).
+Before initializing the tracker, obtain your New Relic configuration:
 
-```shell
-$ npm install @newrelic/video-videojs
+1. Log in to [one.newrelic.com](https://one.newrelic.com)
+2. Navigate to the video agent onboarding flow
+3. Copy your credentials: `licenseKey`, `beacon`, and `applicationId`
+
+### Basic Setup
+
+```javascript
+import VideojsTracker from '@newrelic/video-videojs';
+
+// Initialize Video.js player
+const player = videojs('myVideo');
+
+// Set player version (required)
+player.version = videojs.VERSION;
+
+// Configure tracker with credentials from one.newrelic.com
+const options = {
+  info: {
+    licenseKey: 'YOUR_LICENSE_KEY',
+    beacon: 'YOUR_BEACON_URL',
+    applicationId: 'YOUR_APP_ID',
+  },
+};
+
+// Initialize tracker
+const tracker = new VideojsTracker(player, options);
 ```
 
-```shell
-$ yarn add @newrelic/video-videojs
+### Advanced Configuration
+
+```javascript
+const options = {
+  info: {
+    licenseKey: 'YOUR_LICENSE_KEY',
+    beacon: 'YOUR_BEACON_URL',
+    applicationId: 'YOUR_APP_ID',
+  },
+  config: {
+    qoeAggregate: true, // Enable QoE event aggregation
+    qoeIntervalFactor: 2, // Send QoE events every 2 harvest cycles
+  },
+  customData: {
+    contentTitle: 'My Video Title',
+    customPlayerName: 'MyCustomPlayer',
+    customAttribute: 'customValue',
+  },
+};
+
+const tracker = new VideojsTracker(player, options);
 ```
 
-## Instantiating the Videojs Tracker
+## Best Practices
+
+### 1. Setting `contentTitle`
+
+The `contentTitle` attribute will display a value if your video metadata contains title information. If the metadata does not include a title, `contentTitle` will not be populated. For best results, ensure you explicitly set this attribute during initialization:
+
+```javascript
+const tracker = new VideojsTracker(player, {
+  info: {
+    licenseKey: 'YOUR_LICENSE_KEY',
+    beacon: 'YOUR_BEACON_URL',
+    applicationId: 'YOUR_APP_ID',
+  },
+  customData: {
+    contentTitle: 'My Video Title', // Explicitly set from your metadata
+  },
+});
+```
 
+If your title changes dynamically (e.g., playlist or queue):
 
-> [!NOTE]
-> **Attention:**  
-> This version uses the latest **standalone** version of the Videojs Tracker, In order to initialize it you need to do the following:
+```javascript
+tracker.setOptions({
+  customData: {
+    contentTitle: 'New Video Title',
+  },
+});
+```
 
-Steps to get NREUM config
- - Create a New Relic account and obtain your license key.
- - Install the New Relic Streaming video agent in your application.
- - Configure the video agent with your license key and application ID.
+### 2. Setting `userId`
 
-The NREUM config looks like this:
+Set a user identifier to track video analytics per user:
 
 ```javascript
-/* Get the info object from the video agent onboarding */
-options = {
+// Set userId during initialization
+const tracker = new VideojsTracker(player, {
   info: {
-    beacon: 'xxxxxxxxxxx',
-    licenseKey: 'xxxxxxxxxxx',
-    applicationID: 'xxxxxxxxxxxx',
+    licenseKey: 'YOUR_LICENSE_KEY',
+    beacon: 'YOUR_BEACON_URL',
+    applicationId: 'YOUR_APP_ID',
   },
-};
+  customData: {
+    contentTitle: 'Video Title',
+    userId: 'user-12345',
+  },
+});
+
+// Or set userId separately using the API method
+tracker.setUserId('user-12345');
 ```
 
+### 3. Adding Custom Attributes for Your Deployment
+
+Add custom attributes unique to your deployment to improve data aggregation and analysis:
+
 ```javascript
-import VideojsTracker from "@newrelic/video-videojs";
+const tracker = new VideojsTracker(player, {
+  info: {
+    licenseKey: 'YOUR_LICENSE_KEY',
+    beacon: 'YOUR_BEACON_URL',
+    applicationId: 'YOUR_APP_ID',
+  },
+  customData: {
+    // Required for identification
+    contentTitle: videoMetadata.title,
+    userId: currentUser.id,
+
+    // Custom attributes for your deployment
+    subscriptionTier: 'premium', // User subscription level
+    contentProvider: 'studio-abc', // Content source
+    region: 'us-west-2', // Geographic region
+    cdnProvider: 'cloudflare', // CDN being used
+    deviceType: 'desktop', // Device category
+    appVersion: '2.1.0', // Your app version
+    campaign: 'spring-promo', // Marketing campaign
+  },
+});
+```
+
+**Use these attributes in New Relic queries:**
+
+```sql
+-- Analyze by subscription tier
+SELECT count(*) FROM VideoAction WHERE actionName = 'CONTENT_START'
+FACET subscriptionTier SINCE 1 day ago
+
+-- Monitor by region
+SELECT average(contentNetworkDownloadBitrate) FROM VideoAction
+FACET region SINCE 1 hour ago
+```
+
+### 4. Gradual Rollout with Feature Flags
 
-// pass player version
+When deploying to production, use feature flags to enable the tracker gradually. This helps you:
+
+- Validate data collection without impacting all users
+- Monitor performance impact at scale
+- Catch issues before full deployment
+- Control monitoring costs
+
+```javascript
+// Example using a feature flag
+const rolloutPercentage = 5; // Start with 5% of users
+
+function shouldEnableTracking(userId) {
+  // Simple percentage-based rollout
+  const hash = userId
+    .split('')
+    .reduce((acc, char) => acc + char.charCodeAt(0), 0);
+  return hash % 100 < rolloutPercentage;
+}
+
+const player = videojs('myVideo');
 player.version = videojs.VERSION;
 
-// initialize VideojsTracker with player and options
-const tracker = new VideojsTracker(player, options);
+// Only initialize tracker if user is in rollout
+if (shouldEnableTracking(currentUser.id)) {
+  const tracker = new VideojsTracker(player, {
+    info: {
+      licenseKey: 'YOUR_LICENSE_KEY',
+      beacon: 'YOUR_BEACON_URL',
+      applicationId: 'YOUR_APP_ID',
+    },
+    customData: {
+      contentTitle: videoMetadata.title,
+      userId: currentUser.id,
+      rolloutGroup: `${rolloutPercentage}%`, // Track which rollout group
+    },
+  });
+}
+```
 
-// ================================================= //
+**Recommended Rollout Schedule:**
 
-//For setting custom attributes const tracker
-const tracker = new VideojsTracker(player, {
+| Phase     | Percentage | Duration  | Validation                         |
+| --------- | ---------- | --------- | ---------------------------------- |
+| Initial   | 5%         | 2-3 days  | Verify data flowing to New Relic   |
+| Early     | 15%        | 3-5 days  | Check data quality and performance |
+| Expansion | 25%        | 5-7 days  | Validate across device types       |
+| Majority  | 50%        | 1-2 weeks | Monitor at scale                   |
+| Full      | 100%       | Ongoing   | Complete deployment                |
+
+## Configuration Options
+
+### QoE (Quality of Experience) Settings
+
+| Option              | Type    | Default | Description                                                                                                                                                                              |
+| ------------------- | ------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `qoeAggregate`      | boolean | `false` | Enable Quality of Experience event aggregation. Set to `true` to collect QoE metrics like startup time, buffering, and average bitrate.                                                  |
+| `qoeIntervalFactor` | number  | `1`     | Controls QoE event frequency. A value of `N` sends QoE events once every N harvest cycles. Must be a positive integer. QoE events are always included on first and final harvest cycles. |
+
+### Custom Data
+
+Add custom attributes to all events:
+
+```javascript
+customData: {
+  contentTitle: 'My Video Title',      // Override video title
+  customPlayerName: 'MyPlayer',        // Custom player identifier
+  customPlayerVersion: '1.0.0',        // Custom player version
+  userId: '12345',                     // User identifier
+  // Add any custom attributes you need
+}
+```
+
+> **Limit:** The maximum total number of custom attributes per event is **150**. Any attributes beyond this limit will be dropped.
+
+> **Note:** There are special reserved keywords used for default attributes (such as `actionName`, `contentBitrate`, `playerName`, `viewSession`, etc.). Please do not use these as custom attribute names, as they will be dropped. See [DATAMODEL.md](./DATAMODEL.md) for the complete list of reserved attribute names.
+
+## API Reference
+
+### Core Methods
+
+#### `tracker.setUserId(userId)`
+
+Set a unique identifier for the current user.
+
+```javascript
+tracker.setUserId('user-12345');
+```
+
+#### `tracker.setHarvestInterval(milliseconds)`
+
+Configure how frequently data is sent to New Relic. Accepts values between 1000ms (1 second) and 300000ms (5 minutes).
+
+```javascript
+tracker.setHarvestInterval(30000); // Send data every 30 seconds
+```
+
+#### `tracker.sendCustom(actionName, attributes)`
+
+Send custom events with arbitrary attributes.
+
+```javascript
+tracker.sendCustom('VideoBookmarked', {
+  timestamp: Date.now(),
+  position: player.currentTime(),
+  userId: 'user-12345',
+  bookmarkId: 'bookmark-789',
+});
+```
+
+#### `tracker.setOptions(options)`
+
+Update tracker configuration after initialization.
+
+```javascript
+tracker.setOptions({
   customData: {
-    contentTitle: 'Override Existing Title',
-    customPlayerName: 'myGreatPlayer',
-    customPlayerVersion: '9.4.2',
+    contentTitle: 'New Video Title',
+    season: '1',
+    episode: '3',
+  },
+});
+```
+
+### Example: Complete Integration
+
+```javascript
+import VideojsTracker from '@newrelic/video-videojs';
+
+// Initialize player and tracker
+const player = videojs('myVideo');
+player.version = videojs.VERSION;
+
+const tracker = new VideojsTracker(player, {
+  info: {
+    licenseKey: 'YOUR_LICENSE_KEY',
+    beacon: 'YOUR_BEACON_URL',
+    applicationId: 'YOUR_APP_ID',
   },
+  config: {
+    qoeAggregate: true,
+  },
+});
+
+// Set user context
+tracker.setUserId('user-12345');
+
+// Configure reporting interval
+tracker.setHarvestInterval(30000);
+
+// Send custom events
+player.on('userEngagement', () => {
+  tracker.sendCustom('UserEngaged', {
+    action: 'like',
+    timestamp: Date.now(),
+  });
 });
+```
+
+## Bitrate Metrics
 
-// For setting userId
-tracker.setUserId('userId');
+The tracker captures four distinct bitrate metrics providing complete quality analysis:
 
-// set tracker interval, between 1s - 5mins
-tracker.setHarvestInterval(1000)
+| Attribute                       | Description                                                                                                                       | Use Case                                     |
+| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
+| `contentBitrate`                | Encoding bitrate (in bps) of the currently playing rendition from the manifest                                                    | Monitor actual video quality being delivered |
+| `contentManifestBitrate`        | Maximum available bitrate (in bps) across all renditions in the manifest. Represents the highest quality capability of the stream | Understand maximum quality potential         |
+| `contentSegmentDownloadBitrate` | ABR estimated bandwidth (in bps) from the player's stats object, used by the ABR algorithm for quality switching decisions        | Analyze ABR decision-making                  |
+| `contentNetworkDownloadBitrate` | Instantaneous download throughput (in bps) from the most recent segment download. Represents raw network download speed           | Monitor real-time network performance        |
 
-// For Sending custom Action with Attributes
-tracker.sendCustom('CustomAction', { data: "custom-test" })
+### Bitrate Monitoring Example
 
+```javascript
+// All bitrate metrics are automatically captured and sent with each event
+// Access them in New Relic Insights queries:
+
+// NRQL Query Examples:
+// SELECT average(contentNetworkDownloadBitrate) FROM VideoAction WHERE actionName = 'CONTENT_HEARTBEAT'
+// SELECT contentBitrate, contentSegmentDownloadBitrate FROM VideoAction WHERE actionName = 'CONTENT_RENDITION_CHANGE'
 ```
 
-## Support for SSAI Ads
+## Ad Tracking Support
+
+The tracker provides comprehensive ad tracking capabilities:
 
-> [!NOTE]
-> **Attention:**  
-> This version supports tracking for SSAI (Server-Side Ad Insertion), checkout examples in [/samples/dai/index.html](./samples/dai/index.html)
+### Supported Ad Technologies
 
+- **IMA (Interactive Media Ads)** - Google IMA SDK integration
+- **Freewheel** - Freewheel ad platform support
+- **SSAI (Server-Side Ad Insertion)** - Dynamic Ad Insertion (DAI) support
+
+### SSAI/DAI Integration
+
+Server-Side Ad Insertion is fully supported with automatic detection and tracking:
+
+```javascript
+// SSAI is automatically detected - no additional configuration needed
+const tracker = new VideojsTracker(player, options);
+
+// The tracker will automatically capture:
+// - Ad breaks, starts, and completions
+// - Ad quartiles and click events
+// - SSAI-specific metadata
+```
+
+**Example:** See [samples/dai/index.html](./samples/dai/index.html) for a complete SSAI implementation.
 
 ## Data Model
 
-To understand which actions and attributes are captured and emitted by the Videojs Player under different event types, see [DataModel.md](./DATAMODEL.md).
+The tracker captures comprehensive video analytics across four event types:
+
+- **VideoAction** - Playback events (play, pause, buffer, seek, quality changes, heartbeats)
+- **VideoAdAction** - Ad events (ad start, quartiles, completions, clicks)
+- **VideoErrorAction** - Error events (playback failures, network errors, media errors)
+- **VideoCustomAction** - Custom events defined by your application
+
+**Full Documentation:** See [DATAMODEL.md](./DATAMODEL.md) for complete event and attribute reference.
 
 ## Support
 
-New Relic hosts and moderates an online forum where customers can interact with New Relic employees as well as other customers to get help and share best practices. Like all official New Relic open source projects, there's a related Community topic in the New Relic [Explorer's Hub](https://discuss.newrelic.com).
+Should you need assistance with New Relic products, you are in good hands with several support channels.
 
-We encourage you to bring your experiences and questions to the [Explorer's Hub](https://discuss.newrelic.com) where our community members collaborate on solutions and new ideas.
+If the issue has been confirmed as a bug or is a feature request, please file a [GitHub issue](../../issues).
 
-## Contributing
+### Support Channels
 
-We encourage your contributions to improve New Relic Videojs Tracker! Keep in mind when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project. If you have any questions, or to execute our corporate CLA, required if your contribution is on behalf of a company, please drop us an email at opensource@newrelic.com.
+- **[New Relic Documentation](https://docs.newrelic.com)**: Comprehensive guidance for using our platform
+- **[New Relic Community](https://discuss.newrelic.com)**: The best place to engage in troubleshooting questions
+- **[New Relic University](https://learn.newrelic.com)**: A range of online training for New Relic users of every level
+- **[New Relic Technical Support](https://support.newrelic.com)**: 24/7/365 ticketed support. Read more about our [Technical Support Offerings](https://docs.newrelic.com/docs/licenses/license-information/general-usage-licenses/support-plan)
 
-**A note about vulnerabilities**
+### Additional Resources
+
+- **[DATAMODEL.md](./DATAMODEL.md)** - Complete event and attribute reference
+- **[DEVELOPING.md](./DEVELOPING.md)** - Building and testing instructions
+- **[REVIEW.md](./REVIEW.md)** - Code review guidelines
+
+## Contribute
+
+We encourage your contributions to improve the Video.js Tracker! Keep in mind that when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project.
+
+If you have any questions, or to execute our corporate CLA (which is required if your contribution is on behalf of a company), drop us an email at opensource@newrelic.com.
+
+For more details on how best to contribute, see [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+### A note about vulnerabilities
 
 As noted in our [security policy](../../security/policy), New Relic is committed to the privacy and security of our customers and their data. We believe that providing coordinated disclosure by security researchers and engaging with the security community are important means to achieve our security goals.
 
-If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through [our bug bounty program](https://docs.newrelic.com/docs/security/security-privacy/information-security/report-security-vulnerabilities/).
+If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through our [bug bounty program](https://docs.newrelic.com/docs/security/security-privacy/information-security/report-security-vulnerabilities/).
+
+If you would like to contribute to this project, review [these guidelines](./CONTRIBUTING.md).
+
+To all contributors, we thank you! Without your contribution, this project would not be what it is today.
 
 ## License
 
-New Relic Videojs Tracker is licensed under the [Apache 2.0](http://apache.org/licenses/LICENSE-2.0.txt) License.
+The Video.js Tracker is licensed under the [Apache 2.0](http://apache.org/licenses/LICENSE-2.0.txt) License.
+
+The Video.js Tracker also uses source code from third-party libraries. Full details on which libraries are used and the terms under which they are licensed can be found in the [third-party notices document](./THIRD_PARTY_NOTICES.md).