Чтобы сократить количество комментариев, вы, как автор, можете сделать следующее:
1. Убедиться, что повествование строится в соответствии с методическими рекомендациями издателя (вам их предоставят).
2. Целая страница не состоит только из кода или скриншотов (т.е. не больше 75%).
3. Грамматические конструкции понятны читателю.
Не стоит ожидать от редактора определенной подготовки. Его единственная цель состоит в том, чтобы технически контент был в соответствии с правилами издателя - использовались правильные нумерованные списки, стиль форматирования кода был правильный, предложения были читаемыми, к коду была пара поясняющих строк и так далее.
Редактор будет задавать вопросы в стиле "Код выше будет понятен читателям?", а вы будете смотреть на код, видеть там
print("Hello, World") и невольно думать, что с редактором что-то не так.Здесь важно засунуть поглубже свое самолюбие и понять простую вещь: ваша задача - написать крутую книгу; задача редактора - убедиться, что читатель ее прочитает до конца. Вы можете быть сколь угодно крутым инженером, но издатель лучше знает, как распространить книгу среди как можно большего количества людей - и это в ваших же интересах.
Оспаривать комментарии можно и нужно. Вы как профессионал знаете точно, что является термином, что ключевым словом, что стоит обвести курсивом, а какой блок программного кода не нуждается в пояснении. Цикл "первичный черновик - правки - первичный черновик" в среднем у меня занимал 1-2 итерации. Но наивно полагать, что после принятия первичного черновика ваша работа завершена - затем черновик помучают технические обозреватели, затем снова ваш редактор, затем copy редактор, затем корректор... И лишь потом вы получите назад свою работу, чтобы дать свой финальный вердикт. После этого она уйдет в печать, а изменить уже ничего не получится.
Вот вам непрошеный совет - сохраните самый оригинал вашей главы, а потом сравните с тем, что получилось в самом конце.
Приятно или нет, но вы будете очень удивлены.