new doc and modifications on olad docs