diff --git a/plugins/nomad/README.md b/plugins/nomad/README.md
index 1ec9f3d309..c1fc81886e 100644
--- a/plugins/nomad/README.md
+++ b/plugins/nomad/README.md
@@ -1,13 +1,116 @@
-# nomad
+# @backstage/plugin-nomad
-Welcome to the nomad plugin!
+This plugin is a frontend for viewing Nomad job versions and allocations.
-_This plugin was created through the Backstage CLI_
+## Introduction
-## Getting started
+### Nomad
-Your plugin has been added to the example app in this repository, meaning you'll be able to access it by running `yarn start` in the root directory, and then navigating to [/nomad](http://localhost:3000/nomad).
+> A simple and flexible scheduler and orchestrator to deploy and manage containers and non-containerized applications across on-prem and clouds at scale.
-You can also serve the plugin in isolation by running `yarn start` in the plugin directory.
-This method of serving the plugin provides quicker iteration speed and a faster startup and hot reloads.
-It is only meant for local development, and the setup for it can be found inside the [/dev](./dev) directory.
+### Features
+
+At the time of writing, this plugin provides two components:
+
+- a table to view recent [job versions](https://developer.hashicorp.com/nomad/docs/commands/job/history)
+- a table to view [allocations for a job and/or group](https://developer.hashicorp.com/nomad/tutorials/manage-jobs/jobs-inspect)
+
+## Getting Started
+
+### Requirements
+
+You will need a running Nomad cluster. You can follow [this tutorial](https://developer.hashicorp.com/nomad/tutorials/enterprise/production-deployment-guide-vm-with-consul) to learn how to deploy one.
+
+If ACLs are enabled, you will need a `token` with at least [`list-jobs` and `read-jobs` capabilities](https://developer.hashicorp.com/nomad/tutorials/access-control/access-control-policies#namespace-rules). You can check [this tutorial](https://developer.hashicorp.com/nomad/tutorials/access-control/access-control-create-policy) for more info.
+
+### Installation
+
+```bash
+# From your Backstage root directory
+yarn add --cwd packages/app @backstage/plugin-nomad
+```
+
+### Configuration
+
+Add configuration to your [`app-config.yaml`](https://github.com/backstage/backstage/blob/master/app-config.yaml). For example:
+
+```yaml
+nomad:
+ addr: http://localhost:4646
+ token: 70d707b6-3d45-472e-8639-6b15770c19b8
+```
+
+The `token` can be excluded if [ACLs are not enabled](https://developer.hashicorp.com/nomad/api-docs#authentication).
+
+### Annotate Components
+
+There are two annotations for Components in the Service Catalog:
+
+```yaml
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+ annotations:
+ nomad.io/job-id: redis
+ nomad.io/group: 'redis|prometheus-collector'
+```
+
+The `nomad.io/job-id` annotation's value is matched exactly. The `nomad.io/group` annotation's value is used as a regex pattern against `TaskGroup` using [Nomad's server-side filtering](https://developer.hashicorp.com/nomad/api-docs#filtering).
+
+### Job Versions Card
+
+The snippet below adds a card to the overview tab on the EntityPage. It shows versions of a Nomad job associated with a Component in the Catalog.
+
+```typescript
+// In packages/app/src/components/catalog/EntityPage.tsx
+
+import { EntityNomadJobVersionListCard, isNomadJobIDAvailable } from '@backstage/plugin-nomad';
+
+const overviewContent = (
+ ...
+
+
+
+
+
+
+
+);
+```
+
+
+
+
+
+