Обсуждение:Учебник по программированию


Последнее сообщение: 10 лет назад от Ivan Shmakov в теме «О просьбах»

О просьбах

Просьба не вносить никаких изменений в этот учебник! Это пособие для начинающих.

Отмечу, что цель проекта Викиучебник — способствовать совместной разработке учебного (инструктирующего) материала. (О чем упоминает и заглавная страница: «Здесь в вики-среде совместно пишется образовательная литература…»)

В свете этого, просьба не вносить никаких изменений кажется несколько неуместной. Впрочем, если есть какие-то конкретные пожелания по содержанию и оформлению, — уверен, они будут учтены желающими присоединиться к работе над материалом. Тем более, что в текущем виде, учебник содержит ряд тривиальных фактических неточностей, равно как и некоторые не вполне удачные решения в части оформления.

Некоторые из замеченных неточностей:

  • отсутствие завершающих утверждения ; во многих примерах кода;
  • Perl чувствителен к регистру не только переменных, но и операторов и имен функций; как следствие, оператор If не будет верно воспринят — требуется if; аналогично и функция (не оператор!) print;
  • [ч]тобы символ В не воспринимается [sic] как управляющий ставится знак \ (обратной косой черты). — разве символ В когда-либо понимается Perl как управляющий?? напротив, \ используется для того, чтобы сделать управляющий код из следующего за ним символа n.

Касаемо оформления, — использование явных style=, с одной стороны, усложняет правку (опять же, — Викиучебник посвящен совместной работе), но что хуже — может быть помехой просмотру. Так, некоторые пользователи Викиучебника могут выбрать отличный от умолчания стиль оформления (например: с использованием темно-зеленого цвета фона), в результате чего нынешние зеленые заголовки окажутся трудночитаемыми.

Также не очень удачно смотрятся фрагменты, оформленные ведущими пробелами. Во-первых, поскольку содержащийся в таких фрагментах текст не разбивается на строки, длина строки может превысить ширину окна у конкретного пользователя. Во-вторых, в отличие от ведущих пробелов, использование <source lang="perl" /> дает также и подсветку синтаксиса.

Наконец, поскольку предполагается (!) совместная работа, авторство желательно указать не в тексте учебника, а в «истории» — для чего достаточно зарегистрироваться и, внося изменения, не забывать представляться системе. (Напомню, что регистрация — общая для всех проектов Фонда.)

Ivan Shmakov (ов) 18:21, 14 декабря 2013 (UTC)Ответить

Вернуться на страницу «Учебник по программированию».