Size: a a a

technicalwriters

2020 June 26

SR

Stas Rychkov in technicalwriters
Какая классная документация. Буду использовать для ссылок на лучшие практики.
источник

AS

Anastasiya Selivanav... in technicalwriters
Stas Rychkov
Какая классная документация. Буду использовать для ссылок на лучшие практики.
Ой как приятно, просто бальзам на душу. Не зря я не спала ночами 😀
Но этот сайт — это заслуга не только моя, но ещё и бравых техписов этого чата, которые вовремя дали совет. До сих пор этим людям ОЧЕНЬ благодарна ❤️
источник

S

Sirius in technicalwriters
А есть сильная разница между употреблением parameter, attribute и credential?
с виду кажется тоже самое все - ключ и описание
источник

S

Sirius in technicalwriters
источник

S

Sirius in technicalwriters
Anastasiya Selivanava
Ой как приятно, просто бальзам на душу. Не зря я не спала ночами 😀
Но этот сайт — это заслуга не только моя, но ещё и бравых техписов этого чата, которые вовремя дали совет. До сих пор этим людям ОЧЕНЬ благодарна ❤️
а сколько у вас техрайтеров и сколько времени обычно тратите? интересно просто как это нормально выглядит, не в спешке все самому :)
источник

AS

Anastasiya Selivanav... in technicalwriters
Sirius
а сколько у вас техрайтеров и сколько времени обычно тратите? интересно просто как это нормально выглядит, не в спешке все самому :)
Сайт делала я одна. Вот недавно ещё один техпис пришёл наконец!
источник

AS

Anastasiya Selivanav... in technicalwriters
Sirius
А есть сильная разница между употреблением parameter, attribute и credential?
с виду кажется тоже самое все - ключ и описание
Ох, я уже и не помню, если честно! Давно писала. Credential подходил, видимо, только в этом конкретном случае. Но я вот сейчас засомневалась, корректно ли вообще так писать.
источник

AS

Anastasiya Selivanav... in technicalwriters
Sirius
а сколько у вас техрайтеров и сколько времени обычно тратите? интересно просто как это нормально выглядит, не в спешке все самому :)
Делала в спешке 🙈 Поэтому там все не идеально. А API Reference вообще почти не трогала. Там все от разработчиков — кривые, страшные описания.
источник

AS

Anastasiya Selivanav... in technicalwriters
Sirius
А есть сильная разница между употреблением parameter, attribute и credential?
с виду кажется тоже самое все - ключ и описание
А вот parameter/attribute, скорее всего, зачастую синонимичные слова.
Для API-запросов я бы использовала слово parameter.
А вот слово attribute видела, что для JSON-ок используется. Но и parameter встречала.
Давно уже просто это изучала — сейчас и не помню.
источник

S

Sirius in technicalwriters
я ещё когда называла в подобной таблице - только там были не параметры запроса, а параметры ответа и описание

И сказали разработчики, что ещё неправильно, что я это параметром называю, это свойство

и вот слово атрибут к свойству больше созвучно, но разницу так и не нашла
источник

AS

Andrei Serikov in technicalwriters
Оригинальная 404 страница
источник

S

Sirius in technicalwriters
Anastasiya Selivanava
Сайт делала я одна. Вот недавно ещё один техпис пришёл наконец!
А по времени сколько заняло? Или не только документацией занимались

Нормально разработчики объясняют что какой параметр означает, или в задаче даже описывает менеджер?
источник

AS

Anastasiya Selivanav... in technicalwriters
Sirius
А по времени сколько заняло? Или не только документацией занимались

Нормально разработчики объясняют что какой параметр означает, или в задаче даже описывает менеджер?
Кажись 3-4 месяца на этот сайт ушло, за исключением нескольких разделов.
Менеджера никакого у нас нет 🙈Разработчики плохо объясняют, так как очень занятые. Я обычно сама очень долго и нудно «капаю» каждый параметр и пристаю к разработчикам только в самом конце!
источник

SY

Sofia Yemelianova in technicalwriters
Sirius
я ещё когда называла в подобной таблице - только там были не параметры запроса, а параметры ответа и описание

И сказали разработчики, что ещё неправильно, что я это параметром называю, это свойство

и вот слово атрибут к свойству больше созвучно, но разницу так и не нашла
Верно вам сказали. Параметр запроса — это такая штука, значение которой можно задать, чтобы “повлиять” на результат. А атрибут ответа — это кусочек инфы, который вам возвращает сервер. Как факт.
источник

SY

Sofia Yemelianova in technicalwriters
Вы, наверно, имеете в виду вот этот параметр https://ru.wikipedia.org/wiki/Параметр.
И его можно назвать атрибутом.
А вот этот https://ru.wikipedia.org/wiki/Параметр_(программирование) — нельзя.
источник

S

Sirius in technicalwriters
Спасибо!
источник
2020 June 27

YD

Yuri Dobrev in technicalwriters
здравый смысл не предусмотреть)
источник

K

Kseniya in technicalwriters
источник

K

Kseniya in technicalwriters
Ну и еще вот... от минпросвещения
источник

MS

Maria Shabanova in technicalwriters
Kseniya
Ну и еще вот... от минпросвещения
Что уж говорить, если даже в бланке голосования ошибка)
источник