Компания Google анонсировала (https://opensource.googleblog.com/2019/03/introducing-season...) программу "Season of Docs (https://developers.google.com/season-of-docs/)", похожую на "Summer of Code (http://code.google.com/soc/)", но нацеленную на подготовку документации для открытых проектов. Для участия в программе приглашаются технические писатели, которые совместно с кураторами из открытых проектов попытаются улучшить положение дел с документацией. В случае успешного завершения проекта участники получат (https://developers.google.com/season-of-docs/docs/tech-write...) вознаграждение, размером от 2400 до 6600 долларов, в зависимости от покупательной способности в стране, где проживает участник. Куратор из открытого проекта получит 500 долларов.
Со 2 по 23 апреля будут (https://developers.google.com/season-of-docs/docs/timeline) приниматься заявки на проведение работ от открытых проектов, после чего 30 апреля будет подготовлен список участвующих в программе проектов и их заданий. С 30 апреля по 28 июня технические писатели смогут выбрать проект и отправить заявку на участие. В течение августа технические писатели совместно с кураторами уточнят техническое задание, а на протяжении сентября, октября и ноября попытаются выполнить работу. 10 декабря будут подведены итоги и объявлены успешно выполнившие работу участники.
Кроме непосредственного написания пользовательской документации, в рамках проекта возможно (https://developers.google.com/season-of-docs/docs/faq) и решение сопутствующих задач, таких как создание сайтов с документацией, переработка существующей документации, написание обзорных материалов, написание руководств для участников проекта и т.п. Для оформления документации рекомендован формат Markdown, но конечное решение зависит от пожеланий конкретных открытых проектов.
URL: https://opensource.googleblog.com/2019/03/introducing-season...
Новость: https://www.opennet.me/opennews/art.shtml?num=50295
Полезное начинание, редкость в наше время. Но очень любопытно будет посмотреть на задания.
Не перевозбуждайтесь: мордору проход закрыт.To participate in Season of Docs as a technical writer, you must be:
...
* A resident of a country not currently embargoed by the United States.
Тем не менее украинцы могут, думаю, и белорусы тоже.
Но я не отрицаю что это гадко и подло!
Почему-ж это гадко и подло? Сделайте свой Гугл с гуглокодом и антихерассмент-тимом - и раздавайте всем денюшку за написание документации.
Потому что он дискредитирует опенсорс ставя граждан одних стран выше других!
Гугл лишь соблюдает закон.
> Гугл лишь соблюдает закон.О!
"Что русскому хорошо, то немцу смерть." авторство автора.Модератор, прикрой частичную наготу данной темы. А то росском_чтототам сейчас возбудится. И не будет у нас Google. (Хотя его нужность это вопрос индивидуальный. Но в России есть ли индивидуальность? ;)
Они тебе до сих пор не запрещают писать документацию. И никого по этому принципу отстреливать не будут.
> Они тебе до сих пор не запрещают писать документацию.Вы натурально ничего не понимаете.
Кул-мегахацкиры из России не для того Трампа делали президентом, чтобы бесплатно писать всякую опенсорс-документацию.
Не слишком много ль господа исключительные _возможно_ заплатят за полгода суеты?
Тем, кого мама с папой не содержат - возможно пригодилась бы подобная денюшка за пару-то часов работы на выходных в течении нескольких месяцев.
> Тем, кого мама с папой не содержат - возможно пригодилась бы подобная
> денюшка за пару-то часов работы на выходных в течении нескольких месяцев.Поработать за _возможно_ заплатят? Что-то ты то сам в очередь не рвёшся, а только зазываешь.
> Поработать за _возможно_ заплатят?Как бы нормальные условия в моей стране. СпасибоПутинуЗаЭто!
Только в случае гугла - шанс как бы больший. Не видел, чтобы кого-то кидали в GSOC. Даже в том случае, когда результатом работы стал говнокод, который так и не приняли в проект.
> Что-то ты то сам в очередь не рвёшся
Работаю и бесплатно. Жизнь не удалась?
>> Поработать за _возможно_ заплатят?
> Как бы нормальные условия в моей стране. СпасибоПутинуЗаЭто!Он уже и до Гугла добрался.
> Только в случае гугла - шанс как бы больший. Не видел,
> чтобы кого-то кидали в GSOC. Даже в том случае, когда
> результатом работы стал говнокод, который так и не приняли в проект.Кидок там сразу в условиях, в разбросе размера "вознаграждения".
>> Что-то ты то сам в очередь не рвёшся
> Работаю и бесплатно. Жизнь не удалась?Твоя жизнь, тебе и судить. Другое дело, что это другая тема.
>>> Поработать за _возможно_ заплатят?
>> Как бы нормальные условия в моей стране. СпасибоПутинуЗаЭто!
> Он уже и до Гугла добрался.К счастью, нет, за Гугл вы не волновайтесь.
>> Только в случае гугла - шанс как бы больший. Не видел,
>> чтобы кого-то кидали в GSOC. Даже в том случае, когда
>> результатом работы стал говнокод, который так и не приняли в проект.
> Кидок там сразу в условиях, в разбросе размера "вознаграждения".Что вам мешает уточнить до траты своего исключительно ценного времени?
> Твоя жизнь, тебе и судить.
Мне казалось, что вы хотели выразить свое ценное мнение еще и об этом.
>>>> Поработать за _возможно_ заплатят?
>>> Как бы нормальные условия в моей стране. СпасибоПутинуЗаЭто!
>> Он уже и до Гугла добрался.
> К счастью, нет, за Гугл вы не волновайтесь.Да, тут пора волноваться за кого-то другого. То ваш бог виноват, что Гугл _возможно_ заплатит, то вдруг уже нет.
>>> Только в случае гугла - шанс как бы больший. Не видел,
>>> чтобы кого-то кидали в GSOC. Даже в том случае, когда
>>> результатом работы стал говнокод, который так и не приняли в проект.
>> Кидок там сразу в условиях, в разбросе размера "вознаграждения".
> Что вам мешает уточнить до траты своего исключительно ценного времени?Что вам мешает понять, что я уточнил словом "кидок"?
>> Твоя жизнь, тебе и судить.
> Мне казалось, что вы хотели выразить свое ценное мнение еще и об
> этом.А не кажется, что по себе других не судят?
> Да, тут пора волноваться за кого-то другого.Натурально, за (весьма вероятно) половозрелого гражданина, не овладевшего навыками чтения.
> Что вам мешает понять, что я уточнил словом "кидок"?
Вы можете назвать что угодно чем угодно. Почему мне это должно быть интересным?
>> Да, тут пора волноваться за кого-то другого.
> Натурально, за (весьма вероятно) половозрелого гражданина, не овладевшего навыками чтения.Так укажи, что именно вызывает затруднения при прочтении, попробую перефразировать.
>> Что вам мешает понять, что я уточнил словом "кидок"?
> Вы можете назвать что угодно чем угодно. Почему мне это должно
> быть интересным?Не интересно это тебе, ты задаёшь вопросы без цели, просто потому что тебя так научили сайентологи.
> Что вам мешает уточнить до траты своего исключительно ценного времени?
>> Натурально, за (весьма вероятно) половозрелого гражданина, не овладевшего навыками чтения.
> Так укажи, что именно вызывает затруднения при прочтении, попробую перефразировать.Боюсь, научить вас читать по интернету - я таки не смогу.
>>> Натурально, за (весьма вероятно) половозрелого гражданина, не овладевшего навыками чтения.
>> Так укажи, что именно вызывает затруднения при прочтении, попробую перефразировать.
> Боюсь, научить вас читать по интернету - я таки не смогу.Зато сам научишься.
Россия не является страной, в отношении которой действует эмбарго США. Санкции != эмбарго. Можно зайти на сайт Season of Docs и убедится, что РФ есть в списке стран.Точно такие же правила действуют в GSoC, где Россия успешно представлена.
> Можно зайти на сайт Season of Docs и убедится, что РФ есть в списке стран.Я рад, что вы убедились. А теперь ссылку на "список стран", чтобы не быть "ну ты понел"?
> Точно такие же правила действуют в GSoC, где Россия успешно представлена.
Ни разу не видел студентов из России.
>> Можно зайти на сайт Season of Docs и убедится, что РФ есть в списке стран.
> Я рад, что вы убедились. А теперь ссылку на "список стран",Да, давай список стран.
> чтобы не быть "ну ты понел"?
>> Можно зайти на сайт Season of Docs и убедится, что РФ есть в списке стран.
> Я рад, что вы убедились. А теперь ссылку на "список стран",
> чтобы не быть "ну ты понел"?Вот список стран, участвующих в этом году в Google Summer of Code:
https://developers.google.com/open-source/gsoc/help/student-...
и в Google Summer of Docs:
https://developers.google.com/season-of-docs/docs/tech-write...Russian Federation в обоих списках есть, а вот, например, Iran или North Korea — нет.
>> Точно такие же правила действуют в GSoC, где Россия успешно представлена.
> Ни разу не видел студентов из России.Глаза протри. В 2018 году было 35 студентов из России:
https://opensource.googleblog.com/2018/05/google-summer-of-c...
> Вот список стран, участвующих в этом году в Google Summer of Code:
> https://developers.google.com/open-source/gsoc/help/student-...
> и в Google Summer of Docs:
> https://developers.google.com/season-of-docs/docs/tech-write...
> Russian Federation в обоих списках есть, а вот, например, Iran или North Korea — нет.Хорошо. А теперь, внимание, вопрос: где тут про организации?
>>> Точно такие же правила действуют в GSoC, где Россия успешно представлена.
>> Ни разу не видел студентов из России.
> Глаза протри. В 2018 году было 35 студентов из России:
> https://opensource.googleblog.com/2018/05/google-summer-of-c...Интересно, спасибо. Что, увы, не отменяет того факта, что я с ними не сталкивался. Может какой-нибудь phpBB гуглокодируют или еще какую псятину.
>> Вот список стран, участвующих в этом году в Google Summer of Code:
>> https://developers.google.com/open-source/gsoc/help/student-...
>> и в Google Summer of Docs:
>> https://developers.google.com/season-of-docs/docs/tech-write...
>> Russian Federation в обоих списках есть, а вот, например, Iran или North Korea — нет.
> Хорошо. А теперь, внимание, вопрос: где тут про организации?Доказывать исходный "тезис" (проход закрыт) следует его автору - то есть тебе. Впрочем, твоё признание в неспособности читать снимает с тебя такую обязанность.
> Доказывать исходный "тезис" (проход закрыт) следует его автору - то есть тебе.https://developers.google.com/season-of-docs/terms/program-r...
Читайте п. 4.
> Впрочем, твоё признание в неспособности читать снимает с тебя такую обязанность.
Вообще-то я лишь констатировал неумение читать одного анонима. Может даже вас, ежели уж так пригорает...
>> Вот список стран, участвующих в этом году в Google Summer of Code:
>> https://developers.google.com/open-source/gsoc/help/student-...
>> и в Google Summer of Docs:
>> https://developers.google.com/season-of-docs/docs/tech-write...
>> Russian Federation в обоих списках есть, а вот, например, Iran или North Korea — нет.
> Хорошо. А теперь, внимание, вопрос: где тут про организации?А какая разница? Ограничения по странам для студентов и для организаций одинаковые.
Но, между прочим, могу привести пример организации, расположенной в РФ и руководимой людьми из РФ, которых я лично знаю:
https://summerofcode.withgoogle.com/organizations/5778659590.../Они уже много лет участвуют в программе. Успехов им и в этом году.
И да, студенты из РФ у них тоже бывают. Вот и ответ, чем они занимаются, никакой это не php, а очень важный системный инструмент.
>>> Вот список стран, участвующих в этом году в Google Summer of Code:
>>> https://developers.google.com/open-source/gsoc/help/student-...
>>> и в Google Summer of Docs:
>>> https://developers.google.com/season-of-docs/docs/tech-write...
>>> Russian Federation в обоих списках есть, а вот, например, Iran или North Korea — нет.
>> Хорошо. А теперь, внимание, вопрос: где тут про организации?
> А какая разница? Ограничения по странам для студентов и для организаций одинаковые.Здравый смысл? Не, не слышали.
Ну элементарно же. Эмбарго - оно чтоб террористам технологии не заполучить. А тут ***се - школие спонсируют, штоб оно клятым террорюгам документацию/код писало.
> Но, между прочим, могу привести пример организации, расположенной в РФ и руководимой
> людьми из РФ, которых я лично знаю:
> https://summerofcode.withgoogle.com/organizations/5778659590.../strace? Шутку понял, смешно.
> Они уже много лет участвуют в программе. Успехов им и в этом году.
Успехов, да. Тем не менее, "полтора разраба из России^W^Wпредположительно из России" != "расположена и руководима из РФ".
> И да, студенты из РФ у них тоже бывают. Вот и ответ,
> чем они занимаются, никакой это не php, а очень важный системный инструмент.Поддержка окаменелого г-на мамонта - исключительно важная задача. SystemTap? Не, не слышали.
Интересно что выйдет. Но ещё интересней выяснить почему же у разрабов проектов так плохо с документацией.
Лень и ограниченный словарный запас
Во-первых, не увсех плохо, а во-вторых, может быть просто некогда. Наваял что-то для себя, выложил для всех, доки кратенько набросал и готово. А потом появляется юное даврование, которому надо всё разжевать и в рот положить, желательно - в виде пошаговой видеоинструкции на Ютубе.
Это как раз очевидно:
1) код писать интересно, а документацию писать скучно и лениво - а тем более поддерживать ее в актуальном состоянии;
2) то, что разработчик в своем родном коде считает очевидным, далеко не всегда таковым является, особенно для менее опытных коллег.
Не очевидно, так как существует, к примеру, Doxygen, а комментарии это составная часть кода.
Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API кода. Season of Docs же предназначен для пользовательской документации. Это два существенно различных вида документации. Например, doxygen никак не поможет пользователю GIMP узнать как создать альфа-канал и применить по нему фильтр.
> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API
> кода. Season of Docs же предназначен для пользовательской документации. Это два
> существенно различных вида документации. Например, doxygen никак не поможет пользователю
> GIMP узнать как создать альфа-канал и применить по нему фильтр.Иначе говоря, в коде GIMP упомянутая операция никак не документирована.
>> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API
>> кода. Season of Docs же предназначен для пользовательской документации. Это два
>> существенно различных вида документации. Например, doxygen никак не поможет пользователю
>> GIMP узнать как создать альфа-канал и применить по нему фильтр.
> Иначе говоря, в коде GIMP упомянутая операция никак не документирована.Пользователь (не разработчик!) по коду не сможет понять, как эту опцию использовать. Да и вряд ли её вообще там найдёт.
>>> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API
>>> кода. Season of Docs же предназначен для пользовательской документации. Это два
>>> существенно различных вида документации. Например, doxygen никак не поможет пользователю
>>> GIMP узнать как создать альфа-канал и применить по нему фильтр.
>> Иначе говоря, в коде GIMP упомянутая операция никак не документирована.
> Пользователь (не разработчик!) по коду не сможет понять, как эту опцию использовать.
> Да и вряд ли её вообще там найдёт.Так doxygen находит и формирует документацию. Другое дело, если комментарии в коде касаются лишь сигнатур функций, расшифровывая сокращённые имена и дублируя код, но не описывают доступным языком что же программа на самом деле делает, то да, в итоге пользователю читать оказывается нечего.
почему плохо, не все знают про doxygen
> Но ещё интересней выяснить почему же у разрабов проектов так плохо с документацией.СистемД пример заразителен, не?
посмотрел я этот markdown. ну ничего сложного, но геморно будет набирать документацию. интересно редакторов по нему много? а с документацией в линуксе было плохо всегда. вот сколько помню все что более менее легко найти это man или info. что касается доков для обычного юзверя как например в кхелпере всегда было оч плохо и с отставанием на многие версии. эта задумка гугла случайно не для того чтобы создать еще одну ось на базе линукса с хорошей документацией, но в итоге платной или закрытой частью?
Если ты не знаешь что такое Markdown и не знаешь про редакторы то что ты тут вообще делаешь?
я тут смотрю на тупеющее поколение, которое все больше и больше изобретает велосипеды. и уж если говорить о лучшем языке разметки текста то это будет латекс. но он сложнее, хотя и круче. и не надо мне тут умничать. вычислительные системы настолько широкая область деятельности, что хоть убейся всю знать не будешь никогда. слишком много направлений. вот и ты тут сидишь и умничаешь типа умнейший ты наш. потише будь за умного примут)))
Латех
> документацией в линуксе было плохо всегдаТы, наверное, MSDN не видел ... Вот где плохо-то.
> вознаграждение, размером от 2400 до 6600 долларов, в зависимости от покупательной способности в стране, где проживает участник.М-де.
...в зависимости от покупательской способности Гугла* (и далее по тексту)
Я даже сначала Гуголь похвалить хотел за уникальную инициативу, возможно даже поучаствовать, написав доку для системды, включая на русском.
Но ознакомившись бегло с условиями...
> A resident of a country not currently embargoed by the United States.
> в зависимости от покупательной способности в стране, где проживает участник.Ну его в пень! На текущей работе заработаю больше, а главное с куда большим удовольствием!
Гугл так разпереживался, что не может вам здесь ответить. Ушол, жрет галстух в углу. Что вы наделали?!
Russia is not a country currently embargoed by the United States.
Теперь будет не только индусский код, но и индусская документация?!
И всё это будет лежать в индусской системе контроля версий на gitahub.com
> Компания GoogleИ здесь Гоогле? Начинание, может и хорошее - но начинатели уже не вызывают доверия.
это начинание попахивает попыткой создать систему с хорошей документацией. благое, да только гугл никогда не был беззастенчивым спонсором добра и справедливости. тут попахивает своей версией системы ( к тому же с платными компонентами) и использованием этих программ. по итогу практически готовая система альтернатива виндовс. возможно даже их хромоось))