В свете вопроса создания автоматической сборки инсталляторов для разных платформ возник вопрос с документацией.
Преобразовывать документацию в процессе компиляции можно, но это не так уж и просто. Кроме того большая часть документации у нас доступна только на сайте http://nemerle.org, в формате Вики.
Собственно вопрос в том нужно ли вообще помещать в дистрибутив документацию? Не достаточно ли наличия Вики в Интернете? На мой взгляд — достаточно.
Прошу высказываться.
Есть логика намерений и логика обстоятельств, последняя всегда сильнее.
VD>Собственно вопрос в том нужно ли вообще помещать в дистрибутив документацию? Не достаточно ли наличия Вики в Интернете? На мой взгляд — достаточно.
VD>Прошу высказываться.
У меня на рабочей машине нету интернетов, так что на мой взгляд — недостаточно.
Здравствуйте, VladD2, Вы писали:
VD>Прошу высказываться.
Ненужно — учиться новому и работать без интернета в 2010 году и позже невозможно. Я офлайновым MSDN уже не пользуюсь — гугл лучше.
А для тех, кому нужна офлайновая можно предусмотреть возможность ее скачать отдельно
Здравствуйте, Flem1234, Вы писали:
F>Здравствуйте, VladD2, Вы писали:
VD>>Прошу высказываться.
F>Ненужно — учиться новому и работать без интернета в 2010 году и позже невозможно. Я офлайновым MSDN уже не пользуюсь — гугл лучше.
Не всегда интернет есть на машине, за которой пишешь код.
Можно сделать отдельный справочный chm файл, раз уже вопрос в сложности автоматизации преобразования при компиляции — кто хочет пусть качает.
KK>Не всегда интернет есть на машине, за которой пишешь код.
Просто из любопытства: почему нет инета?
Здравствуйте, Flem1234, Вы писали:
F>Здравствуйте, Ka3a4oK, Вы писали:
F>Можно сделать отдельный справочный chm файл, раз уже вопрос в сложности автоматизации преобразования при компиляции — кто хочет пусть качает.
KK>>Не всегда интернет есть на машине, за которой пишешь код. F>Просто из любопытства: почему нет инета?
Здравствуйте, Ka3a4oK, Вы писали:
VD>>Собственно вопрос в том нужно ли вообще помещать в дистрибутив документацию? Не достаточно ли наличия Вики в Интернете? На мой взгляд — достаточно.
VD>>Прошу высказываться.
KK>У меня на рабочей машине нету интернетов, так что на мой взгляд — недостаточно.
Дискуссия, насколько я понимаю, насчет того, класть ли офф. документацию в инсталлятор (и усложнить процесс его сборки) или не париться и сделать отдельную закачку.
Если у вас нету интернетов, ту офф. документацию, что есть сейчас, можно просто скачать отдельно.
Re[2]: Нужна ли офлайнн-документация?
От:
Аноним
Дата:
11.11.10 23:38
Оценка:
F>Ненужно — учиться новому и работать без интернета в 2010 году и позже невозможно. Я офлайновым MSDN уже не пользуюсь — гугл лучше. F>А для тех, кому нужна офлайновая можно предусмотреть возможность ее скачать отдельно
Именно в 2010-м году и нужна оффлайновая документация.
Далее оффтопик.
В 2010-й VS хелпы сделали по уродски, если не сказать хуже. Они в онлайне. Теоретически можно скачать для оффлайна. Но. Если вы ставите что-то типа C1 или DevExpress или другие навороченные пакеты, у вас проблема — они интегрируют свою доку в оффлайновую.. пустышку.
Итак, в век интернета и толстых каналов вы хотите воспользоваться F1 и в одном случае попадаете на MSDN, в другом случае попадаете на %уй с комментом что топик не найден, после чего приходится перенастраивать студию, чтобы она искала в оффлайне в локале и нашла вашу доку DevExpress, после чего перенастраиваете обратно чтобы родная .net дока снова работала вся такая онлайновая, потом проклинаете долбо-индусов и свой толстый интернет, и скачиваете все пакеты MSDN себе в оффлайн, чтобы нормально работать.
Проблема современных оперативных онлайновых интернетов со всегда актуальными данными понятна?
Здравствуйте, VladD2, Вы писали:
VD>В свете вопроса создания автоматической сборки инсталляторов для разных платформ возник вопрос с документацией. VD>Преобразовывать документацию в процессе компиляции можно, но это не так уж и просто. Кроме того большая часть документации у нас доступна только на сайте http://nemerle.org, в формате Вики. VD>Собственно вопрос в том нужно ли вообще помещать в дистрибутив документацию? Не достаточно ли наличия Вики в Интернете? На мой взгляд — достаточно. VD>Прошу высказываться.
Думаю, достаточно будет положить какой-нибудь красивый файлик со ссылочками на все доступные документы, включая и русскоязычные материалы — те же статьи здесь.
Здравствуйте, Аноним, Вы писали:
А>Итак, в век интернета и толстых каналов вы хотите воспользоваться F1 и в одном случае попадаете на MSDN, в другом случае попадаете на %уй с комментом что топик не найден, после чего приходится перенастраивать студию, чтобы она искала в оффлайне в локале и нашла вашу доку DevExpress, после чего перенастраиваете обратно чтобы родная .net дока снова работала вся такая онлайновая, потом проклинаете долбо-индусов и свой толстый интернет, и скачиваете все пакеты MSDN себе в оффлайн, чтобы нормально работать.
Я вообще F1 забыл когда пользовался. Методы хорошо перечисляются интелисенсом, а если класс незнаком, то все равно читать справку. А значит я лезу в гугль и первая ссылка на msdn, как правило. Если незнакомая область — тоже в гугль, из которго с большой вероятностью попадешь на msdn и с небольшой — еще куда нибудь, где все описано лучше, чем в msdn — потому он в выдаче и выше.
А>Проблема современных оперативных онлайновых интернетов со всегда актуальными данными понятна?
Нет =(. Ну разве что пропадет вдруг и работа станет. Но та же проблема с электричеством никого не парит.
Здравствуйте, Flem1234, Вы писали:
KK>>Не всегда интернет есть на машине, за которой пишешь код. F>Просто из любопытства: почему нет инета?
Чисто поржать: а почему у тебя в холодильнике нет ведра икры?
По-моему, даже ставить так вопрос смешно — у людей бывает воды-то нет, не то, что телефона! А немерлю друг на флешке принёс. И чего теперь?
При качестве и стоимости нынешнего Интернета, оффлайновый архив обязателен.
Здравствуйте, Flem1234, Вы писали:
F>Я вообще F1 забыл когда пользовался. Методы хорошо перечисляются интелисенсом, а если класс незнаком, то все равно читать справку. А значит я лезу в гугль и первая ссылка на msdn, как правило. Если незнакомая область — тоже в гугль, из которго с большой вероятностью попадешь на msdn и с небольшой — еще куда нибудь, где все описано лучше, чем в msdn — потому он в выдаче и выше.
Полностью согласен, но как оказалась наша с тобой практике не соответствует практике других людей. Кое-кто живет без интернета (видимо начальство справедливо опасается, что лазить будут не в Гугле, а во флэймах).
А>>Проблема современных оперативных онлайновых интернетов со всегда актуальными данными понятна?
F>Нет =(. Ну разве что пропадет вдруг и работа станет. Но та же проблема с электричеством никого не парит.
Справедливости ради надо заметить, что:
1. Электричество пропадает реже Интернета.
2. Электросеть не позволяет ее пользователям убивать время во флэймах. Хотя, если использовать дополнительную аппаратуру в виде телевизора...
Есть логика намерений и логика обстоятельств, последняя всегда сильнее.
Здравствуйте, matumba, Вы писали:
M>При качестве и стоимости нынешнего Интернета, оффлайновый архив обязателен.
Разные люди живут в разных условиях. Я вот уже без Интернета не живу. Хотя бы Жопорез но есть. А обычно есть выделенка с анлимом на 5+ мегабит. Так что, я тоже уже перестал осознавать, что кто-то может жить иначе.
Есть логика намерений и логика обстоятельств, последняя всегда сильнее.
Здравствуйте, matumba, Вы писали:
M>Оффлайновую непременно надо делать — не всегда есть выход в сеть. А в дистр включать не обязательно — можно отдельным пакетом выложить.
Согласен. Думаю, что любая полноценная программа должна содержать оффлайн справку, интернет все-таки не всегда доступен.
Больше всего мне, как пользователю, нравиться когда я захожу на сайт какой-либо программы и могу выбрать разные варианты дистрибутива,например:
Полный дистрибутив программы (со справкой и исходниками)
Минимальный дистрибутив (только программа, без справки и без исходников)
Отдельно справка
Отдельно исходники
