Jefferson

Every Jefferson doc in one place: introducing the JCI Index

Jefferson is an assistant for insurance teams. As it has grown, so has the writing around it: guides that walk through a task, pages that explain how a part of Jefferson works, plans for what comes next, and live sites people use every day. Each was useful on its own. Together, they were getting harder to find.

So we built the JCI Index: one place that gathers every Jefferson document.

What the JCI Index is

The JCI Index is a single page that collects Jefferson's documents and shows each one as a card. It covers the full range of what we write:

  • Guides, for when you want to get something done.
  • How-it-works pages, for when you want to understand what is happening underneath.
  • Plans, for when you want to see where something is headed.
  • Live sites, for when you want to go straight to the thing itself.

Instead of remembering where a document lives, or asking a colleague for the link again, you open the index and scan the cards.

Live and draft, at a glance

Every card carries a badge: live or draft.

That small label answers a question people often have to ask out loud: can I rely on this yet? A live card points to something that is out in the world. A draft card points to something still being worked on, shared so you can see it take shape rather than discover it later.

Here is how that plays out. Say you are about to walk a new team member through part of Jefferson. You open the index, find the guide you need, and check its badge. If it says live, you send it. If it says draft, you know to treat it as work in progress and set expectations accordingly. No guessing, no digging through message threads to work out which version is current.

Jefferson can refresh its own index

An index is only useful if it stays current. Documents get added, drafts become live, plans change. A list that someone has to remember to update tends to fall behind.

So the JCI Index is something Jefferson itself can be asked to refresh. When a new document appears or a status changes, you don't need to edit the page by hand. You ask Jefferson to refresh the index.

We like this for a simple reason: it is the same kind of help Jefferson is built to give insurance teams. A small, repetitive job that matters, handled when you ask for it, so people can spend their attention elsewhere.

Why we document in the open

The JCI Index includes drafts and plans, not just finished, polished pages. That is deliberate.

Insurance teams evaluating or using a tool deserve to see how it works, not just what it promises. Showing our guides and how-it-works pages alongside our plans and drafts means you can see the whole picture: what is ready today, what is still being written, and where things are going.

Documenting in the open also keeps us honest. When a draft sits next to a live page with a clear badge on each, it is plain what is finished and what is not. We would rather show a document marked draft than overstate where something stands.

And it helps us improve. Documents that people can find are documents people actually read, and documents that get read are the ones that get better.

Making answers easy to find

Most questions about a tool are not hard. They are just scattered. The answer exists somewhere, in a guide or a how-it-works page, but finding it takes longer than it should.

The JCI Index is our answer to that. It does not replace the documents themselves. It makes them findable. A few ways it helps:

  • Getting started. New to Jefferson? Open the index and look for the guides. You can see everything available at once instead of piecing it together.
  • Understanding a behavior. Wondering why Jefferson does something a certain way? The how-it-works pages are collected in the same place.
  • Looking ahead. Curious what is planned? Plans have their own cards, with badges that show whether they are live or still in draft.
  • Going straight to work. Need a live site? It is on the index too.

One page, one set of cards, one clear signal on each about whether it is ready.

How to use it

There is not much to learn, which is the point.

  1. Open the JCI Index.
  2. Scan the cards for the guide, how-it-works page, plan or live site you need.
  3. Check the badge: live or draft.
  4. If something looks out of date, ask Jefferson to refresh the index.

The index is a starting point. From any card you go to the document itself.

What this means for your team

If you work with Jefferson, the JCI Index is the place to start when you have a question. Bookmark it and share it with colleagues who are getting up to speed. When you want to know whether a document is ready to rely on, look at the badge.

We built the index because we kept wanting it ourselves. Documentation that is spread out gets overlooked. Documentation that is gathered, labeled and kept current gets used. That is all the JCI Index sets out to do, and we think it does it well.

Every Jefferson doc, in one place, marked live or draft, and refreshed when you ask.