The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Google представил инициативу по стимулированию написания документации для СПО

11.03.2019 22:22

Компания Google анонсировала программу "Season of Docs", похожую на "Summer of Code", но нацеленную на подготовку документации для открытых проектов. Для участия в программе приглашаются технические писатели, которые совместно с кураторами из открытых проектов попытаются улучшить положение дел с документацией. В случае успешного завершения проекта участники получат вознаграждение, размером от 2400 до 6600 долларов, в зависимости от покупательной способности в стране, где проживает участник. Куратор из открытого проекта получит 500 долларов.

Со 2 по 23 апреля будут приниматься заявки на проведение работ от открытых проектов, после чего 30 апреля будет подготовлен список участвующих в программе проектов и их заданий. С 30 апреля по 28 июня технические писатели смогут выбрать проект и отправить заявку на участие. В течение августа технические писатели совместно с кураторами уточнят техническое задание, а на протяжении сентября, октября и ноября попытаются выполнить работу. 10 декабря будут подведены итоги и объявлены успешно выполнившие работу участники.

Кроме непосредственного написания пользовательской документации, в рамках проекта возможно и решение сопутствующих задач, таких как создание сайтов с документацией, переработка существующей документации, написание обзорных материалов, написание руководств для участников проекта и т.п. Для оформления документации рекомендован формат Markdown, но конечное решение зависит от пожеланий конкретных открытых проектов.

  1. Главная ссылка к новости (https://opensource.googleblog....)
  2. OpenNews: Сформирован список организаций, участвующих в Summer of Code 2018
Лицензия: CC-BY
Тип: К сведению
Ключевые слова: google, documentation
При перепечатке указание ссылки на opennet.ru обязательно
Обсуждение (54) Ajax | 1 уровень | Линейный | Раскрыть всё | RSS
  • 1.1, EHLO (?), 23:23, 11/03/2019 [ответить] [﹢﹢﹢] [ · · · ]  
  • +9 +/
    Полезное начинание, редкость в наше время. Но очень любопытно будет посмотреть на задания.
     
     
  • 2.13, myhand (ok), 10:16, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +1 +/
    Не перевозбуждайтесь: мордору проход закрыт.

    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.

     
     
  • 3.14, Ilya Indigo (ok), 11:15, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +2 +/
    Тем не менее украинцы могут, думаю, и белорусы тоже.
    Но я не отрицаю что это гадко и подло!
     
     
  • 4.17, myhand (ok), 12:03, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • –3 +/
    Почему-ж это гадко и подло?  Сделайте свой Гугл с гуглокодом и антихерассмент-тимом - и раздавайте всем денюшку за написание документации.
     
     
  • 5.19, Ilya Indigo (ok), 12:38, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +4 +/
    Потому что он дискредитирует опенсорс ставя граждан одних стран выше других!
     
     
  • 6.20, myhand (ok), 12:50, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +3 +/
    Гугл лишь соблюдает закон.  
     
     
  • 7.41, Аноним (-), 23:01, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • –2 +/
    > Гугл лишь соблюдает закон.  

    О!
    "Что русскому хорошо, то немцу смерть." авторство автора.

    Модератор, прикрой частичную наготу данной темы. А то росском_чтототам сейчас возбудится. И не будет у нас Google. (Хотя его нужность это вопрос индивидуальный. Но в России есть ли индивидуальность? ;)

     
  • 6.47, Аноним (47), 16:31, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Они тебе до сих пор не запрещают писать документацию. И никого по этому принципу отстреливать не будут.
     
     
  • 7.53, myhand (ok), 18:34, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    > Они тебе до сих пор не запрещают писать документацию.

    Вы натурально ничего не понимаете.

    Кул-мегахацкиры из России не для того Трампа делали президентом, чтобы бесплатно писать всякую опенсорс-документацию.

     
  • 3.21, Аноним (21), 12:52, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +2 +/
    Не слишком много ль господа исключительные _возможно_ заплатят за полгода суеты?
     
     
  • 4.24, myhand (ok), 13:23, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • –1 +/
    Тем, кого мама с папой не содержат - возможно пригодилась бы подобная денюшка за пару-то часов работы на выходных в течении нескольких месяцев.
     
     
  • 5.26, Аноним (21), 14:10, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +1 +/
    > Тем, кого мама с папой не содержат - возможно пригодилась бы подобная
    > денюшка за пару-то часов работы на выходных в течении нескольких месяцев.

    Поработать за _возможно_ заплатят? Что-то ты то сам в очередь не рвёшся, а только зазываешь.

     
     
  • 6.27, myhand (ok), 14:28, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    > Поработать за _возможно_ заплатят?

    Как бы нормальные условия в моей стране.  СпасибоПутинуЗаЭто!

    Только в случае гугла - шанс как бы больший.  Не видел, чтобы кого-то кидали в GSOC.  Даже в том случае, когда результатом работы стал говнокод, который так и не приняли в проект.

    > Что-то ты то сам в очередь не рвёшся

    Работаю и бесплатно.  Жизнь не удалась?

     
     
  • 7.30, Аноним (21), 14:54, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    >> Поработать за _возможно_ заплатят?
    > Как бы нормальные условия в моей стране.  СпасибоПутинуЗаЭто!

    Он уже и до Гугла добрался.

    > Только в случае гугла - шанс как бы больший.  Не видел,
    > чтобы кого-то кидали в GSOC.  Даже в том случае, когда
    > результатом работы стал говнокод, который так и не приняли в проект.

    Кидок там сразу в условиях, в разбросе размера "вознаграждения".

    >> Что-то ты то сам в очередь не рвёшся
    > Работаю и бесплатно.  Жизнь не удалась?

    Твоя жизнь, тебе и судить. Другое дело, что это другая тема.

     
     
  • 8.32, myhand (ok), 15:05, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    К счастью, нет, за Гугл вы не волновайтесь Что вам мешает уточнить до траты сво... текст свёрнут, показать
     
     
  • 9.36, Аноним (36), 16:09, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Да, тут пора волноваться за кого-то другого То ваш бог виноват, что Гугл _возмо... текст свёрнут, показать
     
     
  • 10.38, myhand (ok), 17:05, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Натурально, за весьма вероятно половозрелого гражданина, не овладевшего навыка... текст свёрнут, показать
     
     
  • 11.48, Аноним (48), 16:36, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Так укажи, что именно вызывает затруднения при прочтении, попробую перефразирова... текст свёрнут, показать
     
     
  • 12.54, myhand (ok), 18:38, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Боюсь, научить вас читать по интернету - я таки не смогу ... текст свёрнут, показать
     
     
  • 13.58, Аноним (58), 10:06, 14/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Зато сам научишься ... текст свёрнут, показать
     
  • 3.43, bircoph (ok), 00:23, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +4 +/
    Россия не является страной, в отношении которой действует эмбарго США. Санкции != эмбарго. Можно зайти на сайт Season of Docs и убедится, что РФ есть в списке стран.

    Точно такие же правила действуют в GSoC, где Россия успешно представлена.

     
     
  • 4.46, myhand (ok), 10:52, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • –2 +/
    > Можно зайти на сайт Season of Docs и убедится, что РФ есть в списке стран.

    Я рад, что вы убедились.  А теперь ссылку на "список стран", чтобы не быть "ну ты понел"?

    > Точно такие же правила действуют в GSoC, где Россия успешно представлена.

    Ни разу не видел студентов из России.

     
     
  • 5.49, Аноним (48), 16:40, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    >> Можно зайти на сайт Season of Docs и убедится, что РФ есть в списке стран.
    > Я рад, что вы убедились.  А теперь ссылку на "список стран",

    Да, давай список стран.

    > чтобы не быть "ну ты понел"?

     
  • 5.51, bircoph (ok), 17:38, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +1 +/
    >> Можно зайти на сайт Season of Docs и убедится, что РФ есть в списке стран.
    > Я рад, что вы убедились.  А теперь ссылку на "список стран",
    > чтобы не быть "ну ты понел"?

    Вот список стран, участвующих в этом году в Google Summer of Code:
    https://developers.google.com/open-source/gsoc/help/student-stipends
    и в Google Summer of Docs:
    https://developers.google.com/season-of-docs/docs/tech-writer-stipends

    Russian Federation в обоих списках есть, а вот, например, Iran или North Korea — нет.

    >> Точно такие же правила действуют в GSoC, где Россия успешно представлена.
    > Ни разу не видел студентов из России.

    Глаза протри. В 2018 году было 35 студентов из России:
    https://opensource.googleblog.com/2018/05/google-summer-of-code-2018-statistic

     
     
  • 6.55, myhand (ok), 19:07, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • –1 +/
    > Вот список стран, участвующих в этом году в Google Summer of Code:
    > https://developers.google.com/open-source/gsoc/help/student-stipends
    > и в Google Summer of Docs:
    > https://developers.google.com/season-of-docs/docs/tech-writer-stipends
    > Russian Federation в обоих списках есть, а вот, например, Iran или North Korea — нет.

    Хорошо.  А теперь, внимание, вопрос: где тут про организации?

    >>> Точно такие же правила действуют в GSoC, где Россия успешно представлена.
    >> Ни разу не видел студентов из России.
    > Глаза протри. В 2018 году было 35 студентов из России:
    > https://opensource.googleblog.com/2018/05/google-summer-of-code-2018-statistic

    Интересно, спасибо.  Что, увы, не отменяет того факта, что я с ними не сталкивался.  Может какой-нибудь phpBB гуглокодируют или еще какую псятину.

     
     
  • 7.59, Аноним (58), 10:12, 14/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    >> Вот список стран, участвующих в этом году в Google Summer of Code:
    >> https://developers.google.com/open-source/gsoc/help/student-stipends
    >> и в Google Summer of Docs:
    >> https://developers.google.com/season-of-docs/docs/tech-writer-stipends
    >> Russian Federation в обоих списках есть, а вот, например, Iran или North Korea — нет.
    > Хорошо.  А теперь, внимание, вопрос: где тут про организации?

    Доказывать исходный "тезис" (проход закрыт) следует его автору - то есть тебе. Впрочем, твоё признание в неспособности читать снимает с тебя такую обязанность.

     
     
  • 8.61, myhand (ok), 11:06, 14/03/2019 [^] [^^] [^^^] [ответить]  
  • –1 +/
    https developers google com season-of-docs terms program-rules Читайте п 4 В... текст свёрнут, показать
     
  • 7.62, bircoph (ok), 14:01, 14/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    >> Вот список стран, участвующих в этом году в Google Summer of Code:
    >> https://developers.google.com/open-source/gsoc/help/student-stipends
    >> и в Google Summer of Docs:
    >> https://developers.google.com/season-of-docs/docs/tech-writer-stipends
    >> Russian Federation в обоих списках есть, а вот, например, Iran или North Korea — нет.
    > Хорошо.  А теперь, внимание, вопрос: где тут про организации?

    А какая разница? Ограничения по странам для студентов и для организаций одинаковые.

    Но, между прочим, могу привести пример организации, расположенной в РФ и руководимой людьми из РФ, которых я лично знаю:
    https://summerofcode.withgoogle.com/organizations/5778659590275072/

    Они уже много лет участвуют в программе. Успехов им и в этом году.

    И да, студенты из РФ у них тоже бывают. Вот и ответ, чем они занимаются, никакой это не php, а очень важный системный инструмент.

     
     
  • 8.63, myhand (ok), 16:29, 14/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Здравый смысл Не, не слышали Ну элементарно же Эмбарго - оно чтоб террорист... текст свёрнут, показать
     

  • 1.3, Аноним (3), 23:57, 11/03/2019 [ответить] [﹢﹢﹢] [ · · · ]  
  • +1 +/
    Интересно что выйдет. Но ещё интересней выяснить почему же у разрабов проектов так плохо с документацией.
     
     
  • 2.5, Аноним (5), 00:40, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • –1 +/
    Лень и ограниченный словарный запас
     
  • 2.6, YetAnotherOnanym (ok), 01:02, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +2 +/
    Во-первых, не увсех плохо, а во-вторых, может быть просто некогда. Наваял что-то для себя, выложил для всех, доки кратенько набросал и готово. А потом появляется юное даврование, которому надо всё разжевать и в рот положить, желательно - в виде пошаговой видеоинструкции на Ютубе.
     
  • 2.7, KonstantinB (??), 01:56, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +5 +/
    Это как раз очевидно:
    1) код писать интересно, а документацию писать скучно и лениво - а тем более поддерживать ее в актуальном состоянии;
    2) то, что разработчик в своем родном коде считает очевидным, далеко не всегда таковым является, особенно для менее опытных коллег.
     
     
  • 3.10, Аноним (10), 07:29, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Не очевидно, так как существует, к примеру, Doxygen, а комментарии это составная часть кода.
     
     
  • 4.44, bircoph (ok), 00:29, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API кода. Season of Docs же предназначен для пользовательской документации. Это два существенно различных вида документации. Например, doxygen никак не поможет пользователю GIMP узнать как создать альфа-канал и применить по нему фильтр.
     
     
  • 5.50, Аноним (48), 16:42, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    > Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API
    > кода. Season of Docs же предназначен для пользовательской документации. Это два
    > существенно различных вида документации. Например, doxygen никак не поможет пользователю
    > GIMP узнать как создать альфа-канал и применить по нему фильтр.

    Иначе говоря, в коде GIMP упомянутая операция никак не документирована.

     
     
  • 6.52, bircoph (ok), 17:40, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    >> Ты путаешь тёплое с мягким. Doxygen — это техническая документация по API
    >> кода. Season of Docs же предназначен для пользовательской документации. Это два
    >> существенно различных вида документации. Например, doxygen никак не поможет пользователю
    >> GIMP узнать как создать альфа-канал и применить по нему фильтр.
    > Иначе говоря, в коде GIMP упомянутая операция никак не документирована.

    Пользователь (не разработчик!) по коду не сможет понять, как эту опцию использовать. Да и вряд ли её вообще там найдёт.

     
     
  • 7.60, Аноним (58), 10:20, 14/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Так doxygen находит и формирует документацию Другое дело, если комментарии в ко... текст свёрнут, показать
     
  • 2.12, еще_адын_ананим (?), 09:20, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    почему плохо, не все знают про doxygen
     
  • 2.42, Аноним (-), 23:07, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    > Но ещё интересней выяснить почему же у разрабов проектов так плохо с документацией.

    СистемД пример заразителен, не?

     

  • 1.4, Анонимчжан (?), 00:12, 12/03/2019 [ответить] [﹢﹢﹢] [ · · · ]  
  • –6 +/
    посмотрел я этот markdown. ну ничего сложного, но геморно будет набирать документацию. интересно редакторов по нему много? а с документацией в линуксе было плохо всегда. вот сколько помню все что более менее легко найти это man  или info. что касается доков для обычного юзверя как например в кхелпере всегда было оч плохо и с отставанием на многие версии. эта задумка гугла случайно не для того чтобы создать еще одну ось на базе линукса с хорошей документацией, но в итоге платной или закрытой частью?
     
     
  • 2.8, Анонич (?), 02:48, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +2 +/
    Если ты не знаешь что такое Markdown и не знаешь про редакторы то что ты тут вообще делаешь?
     
     
  • 3.15, аноним3 (?), 11:20, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • –3 +/
    я тут смотрю на тупеющее поколение, которое все больше и больше изобретает велосипеды. и уж если говорить о лучшем языке разметки текста то это будет латекс. но он сложнее, хотя и круче. и не надо мне тут умничать. вычислительные системы настолько широкая область деятельности, что хоть убейся всю знать не будешь никогда. слишком много направлений. вот и ты тут сидишь и умничаешь типа умнейший ты наш. потише будь за умного примут)))
     
     
  • 4.22, Зануда (?), 12:57, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +3 +/
    Латех
     
  • 2.39, Аноним (39), 19:38, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +1 +/
    > документацией в линуксе было плохо всегда

    Ты, наверное, MSDN не видел ... Вот где плохо-то.

     

  • 1.9, трурль (?), 03:36, 12/03/2019 [ответить] [﹢﹢﹢] [ · · · ]  
  • +2 +/
    > вознаграждение, размером от 2400 до 6600 долларов, в зависимости от покупательной способности в стране, где проживает участник.

    М-де.

     
     
  • 2.11, Аноним (10), 07:32, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    ...в зависимости от покупательской способности Гугла* (и далее по тексту)
     

  • 1.16, Ilya Indigo (ok), 11:23, 12/03/2019 [ответить] [﹢﹢﹢] [ · · · ]  
  • +2 +/
    Я даже сначала Гуголь похвалить хотел за уникальную инициативу, возможно даже поучаствовать, написав доку для системды, включая на русском.
    Но ознакомившись бегло с условиями...
    > A resident of a country not currently embargoed by the United States.
    > в зависимости от покупательной способности в стране, где проживает участник.

    Ну его в пень! На текущей работе заработаю больше, а главное с куда большим удовольствием!

     
     
  • 2.18, myhand (ok), 12:07, 12/03/2019 [^] [^^] [^^^] [ответить]  
  • –4 +/
    Гугл так разпереживался, что не может вам здесь ответить.  Ушол, жрет галстух в углу.  Что вы наделали?!
     
  • 2.64, Аноним 80_уровня (ok), 20:00, 14/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    Russia is not a country currently embargoed by the United States.
     

  • 1.23, nobody (??), 13:15, 12/03/2019 [ответить] [﹢﹢﹢] [ · · · ]  
  • +4 +/
    Теперь будет не только индусский код, но и индусская документация?!
     
     
  • 2.57, burjui (ok), 03:14, 14/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    И всё это будет лежать в индусской системе контроля версий на gitahub.com
     

  • 1.31, Аноним (31), 14:58, 12/03/2019 [ответить] [﹢﹢﹢] [ · · · ]  
  • +/
    > Компания Google

    И здесь Гоогле? Начинание, может и хорошее - но начинатели уже не вызывают доверия.

     
     
  • 2.45, анонзыы (?), 01:04, 13/03/2019 [^] [^^] [^^^] [ответить]  
  • +/
    это начинание попахивает попыткой создать систему с хорошей документацией. благое, да только гугл никогда не был беззастенчивым спонсором добра и справедливости. тут попахивает своей версией системы ( к тому же с платными компонентами) и использованием этих программ. по итогу практически готовая система альтернатива виндовс. возможно даже их хромоось))
     

     Добавить комментарий
    Имя:
    E-Mail:
    Текст:



    Спонсоры:
    Слёрм
    Inferno Solutions
    Hosting by Ihor
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2019 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру