My personal opinion is that things get very fragile when you start completely rewriting the implementation as the documentation. 
If people want to know exactly how it's implemented they can read the code, we should explain what it's doing rather than exactly how it's doing so it doesn't get out of date if the implementation changes.