http://docs.unity3d.com/ScriptReference/Terrain.html This Terrain page has, in the top right corner, a "Switch to Manual" button, when it is clicked you are brought back to the same page. I don't know if you are implementing a manual for this, But it would be helpful if you were. Also for the Functions that are within this scripting reference, it would be helpful if an example code for each of these was made, and a more elaborate explanation of what each of these do. Examples are listed below; Terrain.Flush It would be useful to know when to call this function, and what it should be called for. The description, "Flushes any change done in the terrain so it takes effect." does not specify what changes will need to be flushed, or when the function needs to be called in code. Terrain.SetNeighbours It would be useful to provide an example of when there is more then 4 tilled terrain objects. Providing image examples of this would be helpful as well. These are quite mundane problems. I'm not to sure if it fits the Documentation section, or it should be moved some where else, or not mentioned at all.
There is a manual entry for terrains. http://docs.unity3d.com/Manual/script-Terrain.html That link must have the wrong URL.