AY
Julia
Коллеги, всем привет. Кто-нибудь использует Markdown/ASCIIDoc как исходник для документации в Confluence?
Вроде кто-то по теме презентацию скидывал сюда года полтора назад
Size: a a a
2021 April 02
AA
Спасибо всем большое за ответы про стрелку!
J
Fox Mulder
А зачем???
просто ведем документацию как код, но заказчику нужно видеть её в Confluence
FM
Julia
просто ведем документацию как код, но заказчику нужно видеть её в Confluence
Ну и используйте обычные вложения )
J
Fox Mulder
Ну и используйте обычные вложения )
о чем именно речь?
FM
Julia
о чем именно речь?
Можно к blank-странице confluence прикрепить файл. Тогда при определённых условиях будет вестись нечто подобное git.
J
Fox Mulder
Можно к blank-странице confluence прикрепить файл. Тогда при определённых условиях будет вестись нечто подобное git.
эээ... а можно почитать/посмотреть, о чем вы говорите? Файл какого формата и расширения? При каких таких определенных условиях?
J
Julia
Коллеги, всем привет. Кто-нибудь использует Markdown/ASCIIDoc как исходник для документации в Confluence?
В общем выслушаю разные предложения. Может, кто-нибудь пользовался макросом для Confluence, который рендерит на лету markdond из url?
FM
Да просто скидывайте туда adoc or md files и обязательно соблюдайте 100% pixel perfection в наименовании файлов.
Тогда все изменения файлов будут видны в дереве и вы сможете в любой момент загрузить какой-либо из них.
Тогда все изменения файлов будут видны в дереве и вы сможете в любой момент загрузить какой-либо из них.
MC
Что-то не могу создать опрос, администраторы отключили эту возможность?
rK
Fox Mulder
Да просто скидывайте туда adoc or md files и обязательно соблюдайте 100% pixel perfection в наименовании файлов.
Тогда все изменения файлов будут видны в дереве и вы сможете в любой момент загрузить какой-либо из них.
Тогда все изменения файлов будут видны в дереве и вы сможете в любой момент загрузить какой-либо из них.
такая схема в конфлюенс с любыми типами файлов, у меня видосы так версионируются, но выше, как я понял, не нужно хранить файлы MD, их нужно отобразить по принципам MD, но в конфлюенс
J
такая схема в конфлюенс с любыми типами файлов, у меня видосы так версионируются, но выше, как я понял, не нужно хранить файлы MD, их нужно отобразить по принципам MD, но в конфлюенс
конечно, md хранятся в репозитории
J
Julia
конечно, md хранятся в репозитории
нужно рендерить их с изображениями на странице Confluence
MC
Кто как называет методы в руссой API документации?
1. По-английски, ибо ЦА понимает язык и он быстрее считывается. Например, GetObjectID.
2 По-русски, ибо дока русская всё же. Например, Получить ID объекта
1. По-английски, ибо ЦА понимает язык и он быстрее считывается. Например, GetObjectID.
2 По-русски, ибо дока русская всё же. Например, Получить ID объекта
rK
Julia
конечно, md хранятся в репозитории
чекни в маркетплэйсе атлассиан что-то типа этого https://marketplace.atlassian.com/apps/1211438/markdown-macro-for-confluence?hosting=server&tab=support
но насчет изображений я хз чё там как будет
но насчет изображений я хз чё там как будет
J
чекни в маркетплэйсе атлассиан что-то типа этого https://marketplace.atlassian.com/apps/1211438/markdown-macro-for-confluence?hosting=server&tab=support
но насчет изображений я хз чё там как будет
но насчет изображений я хз чё там как будет
да, я как раз на него смотрела, но там есть нюансы. Хотелось бы найти живого человека, который пользовался им
BF
Кто как называет методы в руссой API документации?
1. По-английски, ибо ЦА понимает язык и он быстрее считывается. Например, GetObjectID.
2 По-русски, ибо дока русская всё же. Например, Получить ID объекта
1. По-английски, ибо ЦА понимает язык и он быстрее считывается. Например, GetObjectID.
2 По-русски, ибо дока русская всё же. Например, Получить ID объекта
Название метода - это название метода.
VI
+1. Кто как вызывается, то так сам и называется
rK
Julia
да, я как раз на него смотрела, но там есть нюансы. Хотелось бы найти живого человека, который пользовался им
у Семён Факторович спроси, у них на сайте вроде читал, что занимаются в том числе тем, что переводят доки из разных мест в конфу или обратно
MC
я об этом