How Docly works
Where the facts come from
Google Docs keeps a detailed record of every change to a document: what was added or removed, where, when and by which account. It's the same record behind File › Version history.
When you click Analyze writing process, Docly asks Google Docs for that record, using your own Google sign-in. So Docly can only read documents you can already edit, and it sees nothing you couldn't see in version history yourself.
Rebuilding the document
Docly replays every recorded change in order, from the empty document to the final draft, and keeps track of where each character came from along the way.
As a self-check, Docly compares its rebuilt text with Google's own copy of the latest version. If they don't match, a warning at the top of the fact sheet says so, so nobody reads partial numbers as complete.
Sorting out where text came from
While replaying, Docly labels text by how it entered the document:
- Typed: added a few characters at a time. Google saves typing in small pieces, and sometimes saves a burst of fast typing as one slightly bigger piece. Docly recognizes those as typing too.
- Pasted: a larger amount of new text arriving in a single step. By default that means 20 characters or more, and you can change it in settings.
- Moved: text cut or copied from elsewhere in the same document. It keeps its original label. Reorganizing an essay never counts as pasting, and cutting and re-pasting pasted text doesn't turn it into typed text.
- Put back: text that Undo, or an accepted spelling or grammar suggestion, puts back after it was just deleted. That counts as revision, not pasting, unless it adds a meaningful amount of new text.
- Starting text: text that came with the document when it was created, like a Google Classroom template or a copied or uploaded file. It gets its own card, so it's never mixed up with pasting, and Docly points it out when it's a large share of the final text.
- Restored: text that came back when someone restored an earlier version. Docly can't tell how restored text was first written.
Time, sessions and rhythm
Every change in the history has a time:
- Changes close together count as active editing. Longer breaks inside a session count as idle time, and a long break starts a new writing session. You can change both cutoffs in settings.
- Typing speed is typed characters ÷ 5 per minute of active editing. The peak is the fastest one-minute stretch.
- Writing rhythm looks at thinking pauses (2 seconds or longer), where typing picked up again after them, and bursts of typing between pauses.
- Revision compares what was typed with what was kept, and counts how often the writer went back to change earlier parts.
What Docly can't see
- Retyping. Text copied by hand from another screen or from paper counts as typed. Typing speed, rhythm, revision and session patterns can help there.
- Writing done somewhere else. A student who drafts in another document or on a phone and pastes it in shows up as a paste. Docly can't see where or how that text was written.
- Voice typing, Smart Compose and offline edits. These can arrive in larger pieces that look like pastes.
- Documents you can't edit. Google only shares version history with editors. Viewers and commenters can't see it, and neither can Docly.
Docly reads version history the same way Google Docs' own Version history panel does. Google could change that at any time, which could stop Docly from working until it's updated. See For IT and administrators.
What stays private
Docly works entirely in your browser. Document text and names are never sent anywhere, and the only site Docly talks to is Google Docs. The details are in the privacy policy.