DesignPatternsBook
DesignPatternsBook copied to clipboard
SergeyTeplyakov
1-2 Часть - Введения
Часть 1. Серый, я не знаю какая цель стояла перед тобой, когда ты писал ввидение к первой части, но скорее всего она отличается от моих целей, когда я читаю (а не пропускаю) введение. Обычно я там ожидаю:
- описание чего-то, что поможет войти в контекст и лучше усвоить инфу
- краткое описание того что будет в разделе (от части это есть, но мне не хватает фраз "в разделе будет рассмотрено...")
- может какая-то смешная история на тему, что бы разбавить серьёзность кники. Ты вроде затронул тему патернов, но я, как читатеть, не могу найти пользу от этих абзацев. Они слишком общие чтобы быть понятными, но при этом в них есть детали, которые лишние. Т.е. после их чтения я так и не стал разбираться в чём-то и оно наврядли мне пригодиться на протяжении чтения раздела. Если бы я хотел угадать твою цель, то поставил на то, что ты просто пытался зародить интерес читателя, не дав иму ничего конкретного, но заинтересовав для дальнейшего чтения. Если это так, то оставляй всё как есть.
Часть 2. Тут дела получше. Мне очень нравится фраза:
Порождающие паттерны предназначены для решения типовых проблем, который возникают при создании объектов.
Именно такие фразы я жду во введении. Касательно Синглтона - самый холиварный патерн. Я бы или вообще его не упоминал, либо же всё-таки упомянул, что многие его считают антипатерном (хотя бы в ссылке).
Общие мысли: Думаю будет где-то не плохо описать без подробностей конкретных патернов, чем структурные, порождающие и поведенческие патерны отличаются между собой. Возможно этой уйдёт во введение книги. Я бы введения делал по принципу:
- Описание проблем, которые возникают в ходе разработки.
- Фраза типа: "как раз такие проблемы решают поведенческие/ххх/ххх патерны из данного раздела: перечисление описанных паттернов (без деталей). Давайте рассмотрим их более детально."
Возможно это крайне лишнее в тех лит-ре, но я бы риснул и попробывал себя в роли писателя худ. произведений. Как раз во введении можно рассказывать историю созревания молодого программиста, который приходил со своими проблемами к гуру программинга (Сергиусу Великому) и тот его награждал знаниями для решения проблем. А потом: "Если вы хотите узнать, что гугу сказал мистеру Джуну, то читайте дальше этот раздел."
По поводу вступлений, подумаю.
Основное введение уже есть, его тоже можно посмотреть. https://github.com/SergeyTeplyakov/DesignPatternsBook/blob/master/Docx/1%20-%20%D0%92%D1%81%D1%82%D1%83%D0%BF%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5.docx
Я понял, что она есть только в docx формате, сегодня перегоню в md.
Касательно Синглтона - самый холиварный патерн. Я бы или вообще его не упоминал, либо же всё-таки упомянул, что многие его считают антипатерном (хотя бы в ссылке).
Сделаю. Там я упоминаю о недостатке, но сделаю это более явным образом.
По поводу связи между паттернами: сделаю это во введении, поскольку каждая конкретная часть предназначена для конкретных паттернов уже, связать их между собой там не всегда возможно.
Разговорный стиль - это хорошая мысль, но требует очень больших усилий, чтобы он смотрелся нормально.
У меня была такая попытка, вот тут - http://sergeyteplyakov.blogspot.com/2010/12/blog-post.html. В целом, пошло не очень.
Леш, лови полностью переработанное вступление к первой части:)
После него, ИМХО, придется переделывать и все остальные!
Прям как другой человек писал, очень отличается от изначальной манеры повествования и мне так на много больше нравится. Гуд джоб!
Леш, твой легкий пендель меня как-то очень правильно смотивировал. Оно ж было понятно, что исходный вариант был "на отцепись". Когда стало понятно, что это понятно не только мне, пришлось браться за раздел нормально:))
Так же переделаю чутка вступление ко второй части, после чего закрою этот тикет.
З.Ы. Нужен фидбек на вступление к третьей части.
Глянул вступление к третье части. На четвёрочку. Лучше чем первая версия к первой части, но хуже, что финальная к первой части. Не так слажено написано, немного "порвано", но "под пиво" пойдёт. Думаю пока переделывать не обязательно, но если будет час та натхнення, то перепиши.