The handover folder contained handover-index.pdf, handover-introduction.pdf, a set of review comments, and a document called start-here. That document was a list of links. It told a new reader where everything was, but not where the project had got to.

Before moving any files, the useful question was a smaller one: what would someone need to know before opening the first link?

First, explain the choice.

handover-index.pdf put every reference on the opening page. handover-introduction.pdf kept the introduction short and moved the references into references.md. Both looked finished.

The missing information was only a sentence: handover-introduction.pdf was the current choice because a new reader needed a route through the material before seeing all of it. The longer version stayed as a reference, not an alternative still waiting for approval.

That distinction belonged beside the links. Leaving it in a review thread meant asking the next person to repeat the search.

Then, leave an entry point.

The new introduction did not replace the folder. It gave the existing files a reading order and named the one question that was still open.

Inside the project README

Project handover

Start here
Read handover-introduction.pdf, then open references.md.
Current version
handover-introduction.pdf. Keep handover-index.pdf for its annotations.
Why this version
The introduction needs to explain the project before it lists the material.
Still open
Does the reference index need a sentence beside each link?

The page deliberately left out the full history. Someone looking for an old decision could still follow the review links; someone trying to begin no longer had to.

Read it without the folder.

A useful check is to close the working files and read the introduction on its own. Mark every “this,” “the latest,” and “as discussed” that depends on a conversation the reader was not part of.

Replace those shortcuts with the name of a file, the reason for a choice, or a question someone can answer. Then put the README where a new reader will actually see it.

The work stays in its folder. The next person gets a way in.