Size: a a a

DocOps-сообщество

2020 March 01

FM

Fox Mulder in DocOps-сообщество
Я в пятницу глюк поймал. Сайт не обновлялся долгое время. Пришлось перезапустить сервер и только тогда накатились изменения
источник

ML

Maksim Lapshin in DocOps-сообщество
Arina Ballerina
Спасибо за помощь, но -d оно указывает куда вообще все класть, а это у меня в конфиге прописано. а -c кажется для другого тоже.
Не путайте директорию куда все генерировать и знание о том, какой префикс у этого будет на хостинге
источник

NV

Nick Volynkin in DocOps-сообщество
Maksim Lapshin
Не путайте директорию куда все генерировать и знание о том, какой префикс у этого будет на хостинге
там есть переменная конфига baseURL как раз для этого, и она работает как надо
источник

L

Lana in DocOps-сообщество
Arina Ballerina
Спасибо за помощь, но -d оно указывает куда вообще все класть, а это у меня в конфиге прописано. а -c кажется для другого тоже.
Да -с это откуда брать, ссылка на assets это прям огонь
источник
2020 March 02

СФ

Семён Факторович in DocOps-сообщество
Держите до слёзок актуальный привет из 1996. Это кусок внутренней рассылки из Университета Калифорнии. Оформил вам это красиво в заметочку, печатайте, вешайте перед собой и никогда-никогда не забывайте обо всём, что написано в этой памятке. Назовём это манифестом техрайтера.

https://pastebin.com/043wTBYt
источник

СФ

Семён Факторович in DocOps-сообщество
источник

СФ

Семён Факторович in DocOps-сообщество
источник

СФ

Семён Факторович in DocOps-сообщество
Действительно классный манифест
источник

СФ

Семён Факторович in DocOps-сообщество
Многое (пожалуй даже большая часть) применимо для всех видов рабочей коммуникации, не только для доков
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
Побуду адвокатом дьявола: некоторые пункты противоречат друг другу
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
"- Tell them to really read the messages, such as errors, that the computer generates."
"- Don't say "it's in the manual". (You knew that.)"
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
так мы всё-таки шлём людей rtfm или нет?
источник

FM

Fox Mulder in DocOps-сообщество
Так это ж о разном
источник

FM

Fox Mulder in DocOps-сообщество
В первом о том что надо читать сообщения, возникающие при диалоге программы и юзверя. Второе - что не следует посылать людей в ртфм
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
"Люди читать не хотят. В одном случае это терпимо, в другом - нет" Ну ок=)
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
Я согласен на 99% с данным текстом, но есть сценарии (например, когда мы пишем софт для других т.н. "продвинутых пользователей"), когда эти советы противоречивы
источник

I

Igor in DocOps-сообщество
Четверть века прошло с заметки. Кхм
источник

M

Max in DocOps-сообщество
Timofey Zakrevskiy
"Люди читать не хотят. В одном случае это терпимо, в другом - нет" Ну ок=)
Вообще мимо.

Как человек, не чуждый интерфейсов, уверенно скажу, что "читать здесь и сейчас" и "читать когда-то раньше/позже в другом месте" - очень разные сценарии. У них больше отличий, чем общего
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
Max
Вообще мимо.

Как человек, не чуждый интерфейсов, уверенно скажу, что "читать здесь и сейчас" и "читать когда-то раньше/позже в другом месте" - очень разные сценарии. У них больше отличий, чем общего
Я не спорю, что это разные сценарии. На мой - не очень образованный с точки зрения тихписательства - взгляд, люди вообще читать не любят.
источник

H

Hartmann in DocOps-сообщество
Timofey Zakrevskiy
Я не спорю, что это разные сценарии. На мой - не очень образованный с точки зрения тихписательства - взгляд, люди вообще читать не любят.
На мой, точно такой же, взгляд так и есть. ;)
источник