Полагаем, Ваши соображения справедливы.
Вас не случайно смущает употребление сочетания в том числе в этом предложении. И дело не только в пунктуации. Словари говорят, что это сочетание является союзом и используется «для присоединения слов, использующихся для обозначения, выделения человека или предмета, на к-рые среди прочих (прочего) распространяется сказанное в предыдущей части», например: Пришли все, в том числе и Мухин. Многие сотрудники, в том числе он, сейчас в отпуске. В таких случаях в том числе открывает собой присоединительный оборот.
В приведенном Вами предложении нет присоединительного оборота. Сочетание в том числе здесь используется в значении, не зафиксированном словарями, — в значении ‘не только, но и’. Здесь оно показывает, что помимо того, о чем говорится в предложении, подразумевается что-то еще (в Вашем случае — что документация может быть представлена и в других формах, помимо формы интерактивных руководств). Подобные случаи в справочниках не рассмотрены, о чём пишет М. М. Харченко в статье, посвящённой нерешённым проблемам современной пунктуации. Судя по приводимым в статье примерам, в большинстве случаев знаки препинания при таком «самостоятельном» в том числе не требуются. Полагаем, что не требуются они и в Вашем примере.
Если стихотворение небольшое (3 строки), то можно привести строки в подбор:
– А какое ваше любимое стихотворение?
– Вот девушка с газельими глазами Выходит замуж за американца, Зачем Колумб Америку открыл?
Если стихотворение большое (несколько строф), то такое оформление уже будет неудачным. В этом случае можно оформить как обычное стихотворение (в стоблик), а тире поставить только перед первой строфой. В справочнике Д. Э. Розенталя «Пунктуация» (в разделе «Абзацы при прямой речи») приводится правило: «Если передается длинный рассказ со многими абзацами, то тире ставится только перед первым абзацем (ни перед промежуточными абзацами, ни перед последним тире не ставится)». Опираясь на это правило, можно оформить так:
– А какое ваше любимое стихотворение?
– Мне не нравится томность
Ваших скрещенных рук,
И спокойная скромность,
И стыдливый испуг.
Героиня романов Тургенева,
Вы надменны, нежны и чисты,
В вас так много безбурно-осеннего
От аллеи, где кружат листы.
Никогда ничему не поверите,
Прежде чем не сочтете, не смерите,
Никогда, никуда не пойдете,
Коль на карте путей не найдете.
И вам чужд тот безумный охотник,
Что, взойдя на нагую скалу,
В пьяном счастье, в тоске безотчетной
Прямо в солнце пускает стрелу.
Слова «ударение не фиксированное» означают, что в русском языке нет такого правила, согласно которому ударение во всех словах, во всех формах слова, всегда падает на какой-то один слог. Например, в чешском языке ударение фиксированное: оно всегда на первом слоге. И во французском языке ударение фиксированное: оно всегда на последнем слоге. В русском языке ударение не фиксированное, оно свободное, или разноместное: может падать на первый слог (дача), на второй (корова), на третий (проводница)... на последний (виолончелист).
Однако наше ударение не только свободное, но еще и подвижное: в разных формах одного и того же слова может падать на разные морфемы. Например, в слове флаг ударение во множественном числе остается на корне (флаги), а в слове враг – переходит на окончание (враги). Или как в приведенном Вами примере: рука – руку (ударение в винительном падеже переходит на корень), но пила – пилу (ударение в винительном падеже остается на окончании). Именно поэтому какие-либо аналогии здесь «не работают». Во всех спорных случаях следует обращаться к словарям, они фиксируют литературную норму. Норма современного русского языка: рубит, но звонит.
Простите, пожалуйста, за долгий ответ! Через дефис пишутся, во-первых, сложносоставные существительные (плащ-палатка, кран-балка, диван-кровать). Первая часть таких слов не склоняется (плащ-палаткой, кран-балкой, диван-кроватью). В сложносоставных словах между частями есть очень тесная связь, которая и позволяет не склонять первое слово. Во-вторых, дефисное написание имеют конструкции, представляющие собой сочетание определяемого слова с приложением, то есть согласованным определением, выраженным существительным (художник-маринист, инженер-экономист и т. д.). В этом случае склоняются обе части: художником-маринистом, инженером-экономистом. В приведенных примерах мы имеем дело именно с этим случаем, соответственно по правилам мы должны склонять обе части: «Зенита-Казани», «Зенитом-Казанью» и т. д. Это соответствует и реальной языковой практике. Например, новости на канале Sport24 выглядят так: Сегодня, 15 сентября, состоится матч 1-го тура группы А на Кубке Победы между «Зенитом-Казанью» и кемеровским «Кузбассом», и таких примеров много. Хотя надо отметить, что пишущие часто избегают косвенных падежных форм этих конструкций, предпочитая другие варианты формулировок (например, ...между казанским «Зенитом»).
Что касается названия, состоящего из двух слов, то обе его части, конечно, должны склоняться.
С числительными: двум человекам.
Корректное написание: Джон Мак-Аслан.
