doc: add comments on how self.written is updated

1 job for fix_chunking in 55 seconds (queued for 3 seconds)