Что стало с Online MSDN Library?

Модератор: Хакер

Хакер
Телепат
Телепат
Аватара пользователя
 
Сообщения: 16107
Зарегистрирован: 13.11.2005 (Вс) 2:43
Откуда: Казахстан, Петропавловск

Что стало с Online MSDN Library?

Сообщение Хакер » 25.04.2010 (Вс) 4:49

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
Предупреждение: эта тема содержит зашкаливающее количество ненависти.
Чувствительных лиц просим не читать.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *


:shock: :shock: :shock: :shock:
:shock:
:shock:
:shock:

Раньше в MSDN было хорошее дерево и был раздел «Win32 & COM Development». Это был самый хороший и светлый раздел в MSDN Library (с).

А теперь я захожу и что вижу?

Кажется, его нет!

Это же катострофа! Это же значит бесполезность MSDN для нормальных (дотнетчики и винсешники, на вашем языке это называется «классические» или скорее «неуправляемые программисты» (наверное так, да, раз пишут неуправляемый код?)) программистов.

Но подождите!

Быть может с введением нового дебилистического дерева (о нём чуть позже) нужный раздел просто стало не видно?

Ищем по фразе SAFEARRAY.

И что видим? Среди дурацких статей в стиле «Как называется палец между указательным и безымянным» есть только одна статья, имя которой — просто SAFEARRAY. Кликаем.

— И что?
— Это статья из блока о Windows Mobile! :evil:


И есть вторая статья с цифрами — это что-то новенькое из блока «Открытые спецификации». 

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

Потому что ни в одной вкусной документации не напишут так:
If any of the consistency checks fail, the protocol implementation SHOULD<12>

Слова SHOULD, MUST, MUST NOT, написанные непременно в верхнем регистре, — это стиль спецификации, стиль RFC, если хотите, но это не стиль вкусной MSDN-документации. Конструкция из глагола и непонятной числовой ссылки — это не стиль вкусной MSDN-документации.

А есть что-то ещё?

Нет. Всё остальное — это либо статьи в упомянутом выше стиле, либо дотнет-специфичные статьи, потому что наличие в начале статьи пары параметров Namespace и Assembly однозначно выдаёт такую статью.

Ну ладно, это COM-функция, её могли пропустить и убрать из «Win32 & COM Develompent», но что-нибудь базовое же должно быть.

Ищем по «FlushInstructionCache»

И первая же страница ведёт на описание функции, и на странице описания изначально выбрана вкладка «C#», в которой должен быть пример использования функции, но его там нет:

csharp_empty_sample.png
csharp_empty_sample.png (6.59 Кб) Просмотров: 1068

И знаете что главное? Главное, что статья находится в секции «Windows Development».

Это означает, что раздела «Win32 & COM Development» больше нет.

Поплачьте о нём.

По сути из этого следует, что теперь вы должны сломать свои глаза, отделяя дотнет-информацию от Win32-информации. Учитывая направления внутри MS, правильно будет сказать не «отделяя», а «ища needle в haystack'е» (иголку в стоге сена).

В общем: структуру разделов справки полностью изменили. Это может и хорошо и правильно с точки зрения марсианина Гжъяпцйуймолькера или вулкана Эйяфьядлайокудля, но с точки зрения программиста, который давно и регулярно пользуется справкой, это «подстава». Это всё равно, что разом поменять названия всех улиц в городе на день почтальона. Для человека, который пользуется справкой регулярно, дерево содержания — это индекс. Индекс необходим для быстрого нахождения. Теперь нужно всё индексировать заново.

Но есть ещё кое-что

Дизайн классической справочной системы — слева дерево, а справа — бокс для просмотра статьи. Но особо одарённые люди в Microsoft нашли у такого дизайна ФАТАЛЬНЫЙ НЕДОСТАТОК.

Необходимость отображать на экране деревья, например, дерево папок, возникла, наверное, ещё с тех пор, как появилась иерархическая файловая система.

Раньше, когда памяти было мало и дисплеи были небольшими, дерево отображали так, и считали, что это нормально:
old_tree.png
old_tree.png (4.44 Кб) Просмотров: 1078


Именно так выглядит DirView из VB6.

У такого способа отображения есть недостаток: вы не можете видеть, что ещё есть в папке sdk кроме папки win и вы не узнаете, пока не выберете папку sdk, но тогда вы перестанете видеть содержимое папки ddk.

Такой способ отображения признали уродским, неудобным, устаревшим, и перешли к TreeView:
new_tree.png
new_tree.png (5.78 Кб) Просмотров: 1077


На нём прекрасно видно и содержимое sdk и содержимое других развёрнутых папок.

Можно развернуть сразу несколько папок.

Это вкусно и хорошо.

Не нужно тыкать по родителю каждого пункта, чтобы увидеть его сиблинги.


Ещё раз:
Изображение _ _ _ _ _ Изображение

Слева — нормальному разработчику так делать западло. Справа — вкусное дерево.
На данный момент, на 2010 год дела обстоят именно так.


А причём тут MSDN Library?

Очень даже причём.

Раньше там было хороее дерево, такое, как справа. В нём был ещё раздел «Win32 & COM Development», но не это важно. Важно, что дерево было вкусным.

А что теперь?

Уникумы из Microsoft поработали над внешним видом дерева, и теперь оно выглядит так:
supershit_tree.png
supershit_tree.png (4.72 Кб) Просмотров: 1078


Ничего не напоминает?

Нет! Стоп! Не отвечайте! Прежде чем вы ответите, позвольте всего один вопрос:
Посмотрите на первые несколько пунктов на этой картинке. Заклейте изолентой всё лишнее! Я вас прошу! Боитесь испортить монитор? Хорошо, я испорчу свой!

Смотрите:
shit_workarea.jpg
shit_workarea.jpg (19.89 Кб) Просмотров: 1078


А теперь, собственно, вопрос: вы правда считаете, что каждый пиксель этой картинки говорит вам о том, что пункты «Combo Box» и «Control Library» — не одноуровневые, не сиблинги, а что «Combo Box» находится внутри «Control Library», а «Windows Controls» является родителем «Control Library». Правда-правда?


А теперь, внимание! Инструкция: как сделать из гадкого устаревшего дерева воистину рекордно тошнотворный объект.
  1. Уберите иконки к чертовой матери!
  2. Отступы — для даунов; уберите отступы у всех элементов, что выше по уровню, чем выбранный!
  3. Уберите выделение с выделенного пункта, покрасьте его текст в оранжевый!

Вкусняшка готова, извольте откушать!

Пояснительная картинка:
shitty_evolution.png
Пояснительный рисунок
shitty_evolution.png (7.98 Кб) Просмотров: 1077


Люди, которые хорошо видят аналогии, наверняка заметили, что от дерева ничего не осталось. По сути, то, что получилось, является так называемыми хлебными крошками, записанными не в строчку, а в столбик:
shitty_tree_layout.png
shitty_tree_layout.png (9.94 Кб) Просмотров: 1075


Мораль
Ладно, раздел «Win32 & COM Development» служил мне долгие годы. Убили. Ладно, оплачем, стерпим. В конце концов, будущее за прогрессивными технологиями, дотнет рулит, а интересы какого-то Хакера — старого пердуна-маразматика с его технологиями каменного века (Win32 и COM) — никого не волнуют, чтобы держать ради них (какая наглость!) целый отдельный раздел.

Но вот за редизайн дерева автору надо... нет, даже не пулю в лоб, а снаряд калибра 135 мм в репу.

Ждёт ли нас спасение?
К счастью, спасение (пока! тс-сс...) существует. Нужно найти в правой верхней части страницы кнопку «Preferences» и выбрать там Classic View. Адекватное дерево с вкусными плюсиками опять радо видеть вас.

msdn_library_good_tree.png
msdn_library_good_tree.png (5.13 Кб) Просмотров: 1075
—We separate their smiling faces from the rest of their body, Captain.
—That's right! We decapitate them.

Debugger
Продвинутый гуру
Продвинутый гуру
Аватара пользователя
 
Сообщения: 1657
Зарегистрирован: 17.06.2006 (Сб) 15:11

Re: Что стало с Online MSDN Library?

Сообщение Debugger » 25.04.2010 (Вс) 10:06

Сколько злости :shock:
Win32 & COM Development совсем выпилили?
Программист - это локальный бог (С) Я

Nord777
Гуру
Гуру
Аватара пользователя
 
Сообщения: 1144
Зарегистрирован: 22.02.2004 (Вс) 13:15
Откуда: Подольск

Re: Что стало с Online MSDN Library?

Сообщение Nord777 » 25.04.2010 (Вс) 20:50

Отправил картинку в личку
Последний раз редактировалось Nord777 25.04.2010 (Вс) 20:59, всего редактировалось 1 раз.
Microsoft Visual Studio 2008
Microsoft .NET Framework 3.5

Хакер
Телепат
Телепат
Аватара пользователя
 
Сообщения: 16107
Зарегистрирован: 13.11.2005 (Вс) 2:43
Откуда: Казахстан, Петропавловск

Re: Что стало с Online MSDN Library?

Сообщение Хакер » 25.04.2010 (Вс) 20:55

Информация писал(а):Выбранное вложение больше не существует.
—We separate their smiling faces from the rest of their body, Captain.
—That's right! We decapitate them.

MIT
Мега гуру
Мега гуру
Аватара пользователя
 
Сообщения: 2211
Зарегистрирован: 17.09.2006 (Вс) 22:46

Re: Что стало с Online MSDN Library?

Сообщение MIT » 25.04.2010 (Вс) 21:07

Nord777 писал(а):Отправил картинку в личку
А вдруг кому-то еще интересно?
Изображение
You can change your face, but can`t change your mind. No matter what you do.
Создайте еще более понятный интерфейс и мир создаст еще более тупого юзера. (с) Баш

Nord777
Гуру
Гуру
Аватара пользователя
 
Сообщения: 1144
Зарегистрирован: 22.02.2004 (Вс) 13:15
Откуда: Подольск

Re: Что стало с Online MSDN Library?

Сообщение Nord777 » 25.04.2010 (Вс) 21:13

А вдруг кому-то еще интересно?
Возможно я неправильно понял Хакер'а.
Но то, что раньше было в Win32 & COM Development, щас лежит в Windows Development.
Я уж не знаю, как там с полнотой информации... глянул только мельком.
Я скинул картинку дерева(как оно у меня отображается)
Microsoft Visual Studio 2008
Microsoft .NET Framework 3.5

Хакер
Телепат
Телепат
Аватара пользователя
 
Сообщения: 16107
Зарегистрирован: 13.11.2005 (Вс) 2:43
Откуда: Казахстан, Петропавловск

Re: Что стало с Online MSDN Library?

Сообщение Хакер » 25.04.2010 (Вс) 21:16

Часть того, что там была — лежит, но в перемешку с дотнетной информацией, и именно в перемешке — зло.
Другая часть (например SAFEARRAY, которая очень уже COM Development), которая там была, не лежит, а лежит (подобно мусору, о котором забыле) в разделе, посвященному Win CE и мобильным устройствам.
—We separate their smiling faces from the rest of their body, Captain.
—That's right! We decapitate them.

FireFenix
Продвинутый гуру
Продвинутый гуру
Аватара пользователя
 
Сообщения: 1640
Зарегистрирован: 25.05.2007 (Пт) 10:24
Откуда: Mugen no Sora

Re: Что стало с Online MSDN Library?

Сообщение FireFenix » 26.04.2010 (Пн) 10:06

Виноват... третий линк почему-то не отображался и кинул ссылку на тотжий источник :?
Последний раз редактировалось FireFenix 26.04.2010 (Пн) 11:33, всего редактировалось 2 раз(а).
Птицей Гермеса меня называют, свои крылья пожирая... сам себя я укрощаю
私はヘルメスの鳥 私は自らの羽根を喰らい 飼い慣らされる

Хакер
Телепат
Телепат
Аватара пользователя
 
Сообщения: 16107
Зарегистрирован: 13.11.2005 (Вс) 2:43
Откуда: Казахстан, Петропавловск

Re: Что стало с Online MSDN Library?

Сообщение Хакер » 26.04.2010 (Пн) 10:23

Для кого ссылка?
—We separate their smiling faces from the rest of their body, Captain.
—That's right! We decapitate them.

VBTerminator
Постоялец
Постоялец
Аватара пользователя
 
Сообщения: 412
Зарегистрирован: 19.11.2008 (Ср) 20:10
Откуда: Санкт-Петербург

Re: Что стало с Online MSDN Library?

Сообщение VBTerminator » 15.07.2018 (Вс) 19:02

Итак, восемь лет спустя до лиц, принимающих решения, наконец-то дошла ущербность того, на что указывал Хакер, и время обратилось вспять:
Изображение

И даже «Win32 & COM Development» восстал из мёртвых:
Изображение

Пусть ради этого и пришлось перевести всю документацию на другой домен (теперь полный базовый адрес — https://docs.microsoft.com/en-us/windows/desktop/).
Изображение

Да, знаю, синий заголовок Хрома на стандартной теме Win10 выглядит вырвиглазно и отвлекает на себя слишком много внимания. Но повторную переделку картинок с перерисовыванием красной обводки я не осилю, так что прошу у читателей прощения.


Вернуться в Мой блог

Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 4

    TopList