Я придерживаюсь принципа упрощения и автоматизации. Стараюсь не усложнять там, где это не нужно. У меня есть Облако, где я могу поднять центос или убунту. Если мне, например, для юзер гайда будет необходим мак, то я попрошу у коллег.
Усложнение процесса написания документации, очень часто искусственное, приводит в итоге к опусканию самого главного - самой документации и качества контента.
Много статей или гайдов, что я видел, являются или копипастом или содержат нечитаемый формат, в котором канва не выражена.