Комментарии 52
Архитектурно для
Идеально редактируешь у себя на компе, потом commit, и веб сервер уже подхватывает изменения и отображает. Для редактирования нужен редактор, который умеет отображать код как браузер. Все остальное, что пробовал — неудобно.
Так что да, полезное (пока теоретически) нововведение. Особенно, если дока будет оперативно пополняться теми нюансами, о которых спрашивается.
На SO всегда было специальным образом запрещено посылать в гугл и за такие ответы минусуют нещадно. Почитайте правила.
Когда спрашивают элементарное из разряда "Что такое наследование в ООП" или что-то вида "вот задание домашней работы, напишите её за меня", то в гугл в комментариях посылают часто, более того минусуют тех кто отвечает на подобные вопросы.
На вопросы типа «Что такое наследование в ООП» всегда есть готовый ответ на самом SO и я обычно не минусую, а закрываю вопрос как дубликат (после тысячи репутации в рубрике дается возможность помечать дубликатами ответы единолично.)
Не удивительно, документацию должны заапрувить два человека даже если у тебя > 5 тыс. репутации (по крайне мере, у меня более 5 тыс. и все равно приходится ждать принятия).
Когда новый сайт сети стэкэксчендж проходит бета-тестирование, то рамки репутации сильно занижены. С выходом из беты будет повышена репутация, необходимая для редактирования документации, и, скорее всего, нужно будет иметь знак по этой метке.
Это как в приколе из баша (текст примерный):
Учусь в универе на *физмате*. И если на 1-2 курсе информацию к экзаменам еще можно было надыбать в интернете, то уже на 4-5 курсах такой специфической информации в открытом доступе попросту нет и нам просто разрешают пользоваться мобильниками.
Нормально выходит: http://stackoverflow.com/documentation/yii2
stackoverflow.com/documentation/yii2/788/introduction-to-yii-2/2751/install-yii2-advanced-in-ubuntu#t=201607221330133801441
лучше чем здесь:
www.yiiframework.com/doc-2.0/guide-start-installation.html
?
Нет. Документацию мы вылизывали долго, а эта штука только запустилась.
Может лучше новый сайт для Yii допилить?
Так никто особо сил и не тратит. Я там ради интереса пару статеек отредактировал за 10 минут и всё. Новый сайт может помочь допилить кто угодно: https://github.com/yiisoft-contrib/yiiframework.com
1. Документация привязывается к существующему на SO тегу.
2. Если хочется добавить доку к своему проекту и у него есть тег, то надо открыть заявку (proposal).
3. За заявку (proposal) должны проголосовать не менее 5 человек. Голосовать могут только чуваки с положительно оценёными ответами по данному тегу или имеющие репутацию выше 150.
Это только кажется проблемой. На самом деле все решается за день-два.
Нужно создать вопрос на «Мета» с просьбой создать новую метку.
Объяснить, что Вы хотите создать ее для документирования своего фреймворка.
Очень быстро найдутся участники, которые проголосуют за создание метки.
Такие преценденты уже были. Человек с маленькой репутацией переносил с домашней страницы своей библиотеки мануал по ней в формате QA.
Все решаемо. На СО сидят люди, а не роботы.
Решение, которое было актуальное и хорошее в 2013 — уже не так хорошо в 2016, но набрало уже 100500 апвотов.
С документацией будет тоже самое?
Запрос на изменения любого примера в документации может отправить любой, по сути, я так понимаю, будет вики-подобная модель, когда статьи правят всем миром.
То что я увидел в Яве и в еще паре тем больше похоже на гайды (ну если точнее даже на шпоры). Никакой воды, пример и описание. В случае если тебе нужно уточнить что-то конкретное (и ты знаешь, что ты ищешь), сервис идеален. Для меня, с моей дырявой памятью — уж точно.
И в тоже время он слишком краток и архаичен для изучения с 0ля. И я бы лучше оставил именно все так, переименовав сервис во что нибудь более подходящее.
Stackoverflow запустил раздел «Документация»