Getting developers to write documentation is hard enough already. Raising the barrier to entry to include learning complicated markup languages will chase them

Getting developers to write documentation is hard enough already. Raising the barrier to entry to include learning complicated markup languages will chase them off completely. I agree, it's far from perfect. But some documentation is better than none.