СФ
Кто, если не мы:)
Size: a a a
2021 January 07
NV
Давайте придумаем себе (в смысле, нашей профессии) набор визуальных образов?
Вот мои: 🤦♂ 🙅♂ 🤷♂
H
Давайте придумаем себе (в смысле, нашей профессии) набор визуальных образов?
Давайте, да. Будем каждую статью по теме сопровождать фотографией Тома Джонсона с нимбом в качестве иконы.
TZ
Давайте придумаем себе (в смысле, нашей профессии) набор визуальных образов?
"... и лишь программисты не пахнут никак". Простите
NV
"... и лишь программисты не пахнут никак". Простите
Я что-то не могу вспомнить, откуда это
RD
ID:0
Вообще, смешно и грустно, что к половине статей про документацию берут иллюстрацию с клавиатурой, печатной машинкой, пером и чернильницей или чем-то подобным. Как будто основная работа технического писателя в том, чтобы писать. Вот нифига, основная работа — думать и исследовать. Как и у разработчика и у кучи других профессий. Когда хорошо подумаешь, писать несложно.
Мне кажется что эта деятельность ближе к философии и логике; Умение вытянуть мысли из головы других и представить их недвусмысленно и непротиворечиво.
TZ
Я что-то не могу вспомнить, откуда это
Это древнющий баян двадцатилетней давности: http://rsdn.org/forum/humour/1236708.all
NV
Давайте придумаем себе (в смысле, нашей профессии) набор визуальных образов?
Если без шуток, идея хорошая.
СФ
Вот мои: 🤦♂ 🙅♂ 🤷♂
это ко многим профессиям применимо:)
rd
ID:0
Вообще, смешно и грустно, что к половине статей про документацию берут иллюстрацию с клавиатурой, печатной машинкой, пером и чернильницей или чем-то подобным. Как будто основная работа технического писателя в том, чтобы писать. Вот нифига, основная работа — думать и исследовать. Как и у разработчика и у кучи других профессий. Когда хорошо подумаешь, писать несложно.
> берут иллюстрацию с клавиатурой, печатной машинкой, пером и чернильницей или чем-то подобным
Хорошо хоть не так =)
Хорошо хоть не так =)
ВЩ
Привет, возможно уже обсуждалось. Посоветуйте, поалуйста, что-нибудь интересное для документации через маркдаун. Желательно с полноценной админкой в вебе (плюс возможность деплоя через cli. Пайтон сойдёт.. Или это оффтопик?
Глянул mkdocs, симпатишно, но нужен гуёвый интерфейс для юзера
Глянул mkdocs, симпатишно, но нужен гуёвый интерфейс для юзера
H
Привет, возможно уже обсуждалось. Посоветуйте, поалуйста, что-нибудь интересное для документации через маркдаун. Желательно с полноценной админкой в вебе (плюс возможность деплоя через cli. Пайтон сойдёт.. Или это оффтопик?
Глянул mkdocs, симпатишно, но нужен гуёвый интерфейс для юзера
Глянул mkdocs, симпатишно, но нужен гуёвый интерфейс для юзера
H
Текстовка в мд, мд в ссг (например Hugo, Docusaurus, Jekyll, Gatsby), завернуть в Нетлифай, а там деплой в куда надо.
H
Всё. Дан дил.
H
Вдогонку, есть ещё вещи, как
https://typemill.net/
И связка Notion + Netlify.
https://conradlin.com/blog/posts/host-gatsbyjs-blog-with-notion-cms-and-netlify-for-free/
https://typemill.net/
И связка Notion + Netlify.
https://conradlin.com/blog/posts/host-gatsbyjs-blog-with-notion-cms-and-netlify-for-free/
EF
ID:0
Вообще, смешно и грустно, что к половине статей про документацию берут иллюстрацию с клавиатурой, печатной машинкой, пером и чернильницей или чем-то подобным. Как будто основная работа технического писателя в том, чтобы писать. Вот нифига, основная работа — думать и исследовать. Как и у разработчика и у кучи других профессий. Когда хорошо подумаешь, писать несложно.
Так важен же не процесс, а результат. Вот его и иллюстрируют. Плюс стандартные символы мозг быстро категоризирует. По-моему логично. А анализ в любом деле большую часть времени занимает. Простите зануду ☺️
H
Привет, возможно уже обсуждалось. Посоветуйте, поалуйста, что-нибудь интересное для документации через маркдаун. Желательно с полноценной админкой в вебе (плюс возможность деплоя через cli. Пайтон сойдёт.. Или это оффтопик?
Глянул mkdocs, симпатишно, но нужен гуёвый интерфейс для юзера
Глянул mkdocs, симпатишно, но нужен гуёвый интерфейс для юзера
2021 January 08
NK
Таня @rishavant запустила анонимный опрос о зарплатах UX-писателей. Если вы пишете интерфейсные тексты — пожалуйста, ответьте на пару вопросов. Результаты Таня потом опубликует.
https://forms.gle/gJD8Q9zVzmUP3Zbd9
https://forms.gle/gJD8Q9zVzmUP3Zbd9
2021 January 11
NV
гуглил про блоки кода в Sphinx, но что-то пошло не так
JM
Нашёл гуру технической документации