correct urls (hopefully)
document MDS layout