moves apache impl details to note. closes #273