Обсуждение:Учебник по программированию/Архив/2013
Добавить тему
Это завершённое обсуждение. Просьба не вносить изменений.
О просьбах
[править]Просьба не вносить никаких изменений в этот учебник! Это пособие для начинающих.
Отмечу, что цель проекта Викиучебник — способствовать совместной разработке учебного (инструктирующего) материала. (О чем упоминает и заглавная страница: «Здесь в вики-среде совместно пишется образовательная литература…»)
В свете этого, просьба не вносить никаких изменений кажется несколько неуместной. Впрочем, если есть какие-то конкретные пожелания по содержанию и оформлению, — уверен, они будут учтены желающими присоединиться к работе над материалом. Тем более, что в текущем виде, учебник содержит ряд тривиальных фактических неточностей, равно как и некоторые не вполне удачные решения в части оформления.
Некоторые из замеченных неточностей:
- отсутствие завершающих утверждения
;во многих примерах кода; - Perl чувствителен к регистру не только переменных, но и операторов и имен функций; как следствие, оператор
Ifне будет верно воспринят — требуетсяif; аналогично и функция (не оператор!)print; - [ч]тобы символ
Вне воспринимается [sic] как управляющий ставится знак\(обратной косой черты). — разве символВкогда-либо понимается Perl как управляющий?? напротив,\используется для того, чтобы сделать управляющий код из следующего за ним символаn.
Касаемо оформления, — использование явных style=, с одной стороны, усложняет правку (опять же, — Викиучебник посвящен совместной работе), но что хуже — может быть помехой просмотру. Так, некоторые пользователи Викиучебника могут выбрать отличный от умолчания стиль оформления (например: с использованием темно-зеленого цвета фона), в результате чего нынешние зеленые заголовки окажутся трудночитаемыми.
Также не очень удачно смотрятся фрагменты, оформленные ведущими пробелами. Во-первых, поскольку содержащийся в таких фрагментах текст не разбивается на строки, длина строки может превысить ширину окна у конкретного пользователя. Во-вторых, в отличие от ведущих пробелов, использование <source lang="perl" /> дает также и подсветку синтаксиса.
Наконец, поскольку предполагается (!) совместная работа, авторство желательно указать не в тексте учебника, а в «истории» — для чего достаточно зарегистрироваться и, внося изменения, не забывать представляться системе. (Напомню, что регистрация — общая для всех проектов Фонда.)
— Ivan Shmakov (о ▞ в) 18:21, 14 декабря 2013 (UTC)
Почему я прошу не вносить никаких исправлений в мой учебник
[править]Я знаю, что Вики-учебник это онлайн текстовый редактор. Но я прошу не править мой учебник потому, что: многие не знают 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. — такие проблемы с оформлением не составило бы труда устранить, пожалуй, никому из более или менее опытных редакторов Викиучебника, совершенно никак не затрагивая содержание. Не ясно, почему такие правки могли бы вызывать возражения?
Обновления в учебнике
[править]Обновления
ЕСЛИ ВЫ НАЧАЛИ ЧИТАТЬ ЭТОТ УЧЕБНИК, ТО ВАМ СТОИТ ЕГО ПЕРЕЧИТАТЬ 85.26.241.200 04:40, 29 декабря 2013 (UTC)
85.26.241.239 03:53, 29 декабря 2013 (UTC)