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

Это завершённое обсуждение. Просьба не вносить изменений.

О просьбах

Последнее сообщение: 10 лет назад1 сообщение1 человек в обсуждении

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

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

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

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

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

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

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

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

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

Почему я прошу не вносить никаких исправлений в мой учебник

Последнее сообщение: 10 лет назад2 сообщения2 человека в обсуждении

Я знаю, что Вики-учебник это онлайн текстовый редактор. Но я прошу не править мой учебник потому, что: многие не знают Perl (я выучил его с начала сентября). 85.26.241.180 09:33, 15 декабря 2013 (UTC)Ответить

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

В отношении «многие не знают Perl» — не ясно, как это может быть причиной не вносить исправления в разрабатываемый учебник? Тем более, в случае очевидных неточностей. К примеру, выполним код одного из примеров:

$a = "оператор";
$b = "print";
print $a . $b; # результат: оператор print

Результат:

$ perl -e '$a = "оператор"; $b = "print"; print $a . $b;' 
операторprint

Действительно, ни $a, ни $b, ни вызов функции print не содержат пробелов. Откуда бы им взяться в выводе?

Исправленная мной ранее форма print = "текст" также является синтаксически неверной:

$ perl -e 'print = "текст";' 
Can't modify print in scalar assignment at -e line 1, near ""текст";"
Execution of -e aborted due to compilation errors.

Кроме того, остаются пожелания к оформлению: использование <source lang="perl" /> для оформления фрагментов Perl-кода, исключение «лишних» (мешающих просмотру) '''<span />''' из заголовков, etc. — такие проблемы с оформлением не составило бы труда устранить, пожалуй, никому из более или менее опытных редакторов Викиучебника, совершенно никак не затрагивая содержание. Не ясно, почему такие правки могли бы вызывать возражения?

— Ivan Shmakov (о ▞ в) 10:42, 15 декабря 2013 (UTC)Ответить

Обновления в учебнике

Последнее сообщение: 10 лет назад2 сообщения2 человека в обсуждении

Обновления

ЕСЛИ ВЫ НАЧАЛИ ЧИТАТЬ ЭТОТ УЧЕБНИК, ТО ВАМ СТОИТ ЕГО ПЕРЕЧИТАТЬ 85.26.241.200 04:40, 29 декабря 2013 (UTC)Ответить

85.26.241.239 03:53, 29 декабря 2013 (UTC)Ответить