СФ
Дьявол кроется в «более-менее»:)
Size: a a a
2018 October 30
OI
да, безусловно )
OI
но тут как процесс построить. Знаю ребят, которые поставляют решение через час после поступления тикета от заказчика, кодят грязно, пишут юнит-тесты, отправляют, как только код начнет стабильно решать проблему. После отправки ставится задача на рефакторинг
OI
если принять тот факт, что большинство стартапов умирает в первый год, то никто не вспомнит, что у тебя был идеальный код, если бизнес умер ))
I
Есть подозрение, что там один программист :)
ну, я такие истории слышал про Elixir, но искать таких разработчиков непросто, только у себя растить.
При этом разработчика на golang будет проще найти, у кода похожая производительность будет.
При этом разработчика на golang будет проще найти, у кода похожая производительность будет.
OI
ну, я такие истории слышал про Elixir, но искать таких разработчиков непросто, только у себя растить.
При этом разработчика на golang будет проще найти, у кода похожая производительность будет.
При этом разработчика на golang будет проще найти, у кода похожая производительность будет.
его еще попробуй замани этого разработчика на golang ))
I
куда проще заманить на erlang, угу
2018 October 31
AR
подскажите, есть ли ГОСТы для документации в Америке, в Европейских странах, ну и вообще где-либо?
NV
подскажите, есть ли ГОСТы для документации в Америке, в Европейских странах, ну и вообще где-либо?
Отвечу цитатой классика @factorized
NV
можно глянуть на IEEE 1016 Software Design Descriptions и IEEE 830 IEEE Recommended Practice for Software Requirements Specifications
NV
что касается процессов, связанных с документацией, то стоит посмотреть на цепочку стандартов
ISO/IEC/IEEE 26511 Requirements for Managers of User Documentation
ISO/IEC/IEEE 26512 Requirements for Acquirers and Suppliers of User Documentation
ISO/IEC/IEEE 26513 Requirements for Testers and Reviewers of User Documentation
ISO/IEC/IEEE 26514 Requirements for Designers and Developers of User Documentation
ISO/IEC/IEEE 26511 Requirements for Managers of User Documentation
ISO/IEC/IEEE 26512 Requirements for Acquirers and Suppliers of User Documentation
ISO/IEC/IEEE 26513 Requirements for Testers and Reviewers of User Documentation
ISO/IEC/IEEE 26514 Requirements for Designers and Developers of User Documentation
AR
спасибо
ME
коллеги, может у кого в конторе readme.io в качестве основного решения для продуктовой документации? расскажите пожалуйста плюсы, минусы, подводные камни
2018 November 01
NV
коллеги, может у кого в конторе readme.io в качестве основного решения для продуктовой документации? расскажите пожалуйста плюсы, минусы, подводные камни
почитал первую страницу, кажется это фронтенд и хостинг для документации в формате OpenAPI
NV
Я бы так сравнивал: сделал небольшую спеку на два-три метода в OpenAPI, потом опубликовал её разными способами: через readme.io, Swagger, Slate, может там ещё что-то есть.
NV
Смотрел бы на такие критерии:
— удобство редактирования. Можно ли опубликовать тестовое окружение для рецензирования/тестирования? Можно ли покомментировать исходник?
— удобство и контроль за публикацией. Кто может нажать кнопку «Опубликовать», как определяется доступ к ней? Можно ли откатить ошибочную публикацию?
— что нам удобнее: хостить самим или заплатить за хостинг?
— удобство редактирования. Можно ли опубликовать тестовое окружение для рецензирования/тестирования? Можно ли покомментировать исходник?
— удобство и контроль за публикацией. Кто может нажать кнопку «Опубликовать», как определяется доступ к ней? Можно ли откатить ошибочную публикацию?
— что нам удобнее: хостить самим или заплатить за хостинг?
ME
Ник, спасибо огромное
ME
я вчера начиталась отзывов про то, что readme.io начинает тупить, когда речь идет об объёмной документации, поэтому интересны юскейсы тех, кто трудится в кровавом энтерпрайзе с десятками версий/языков одного документационного портала
NV
я вчера начиталась отзывов про то, что readme.io начинает тупить, когда речь идет об объёмной документации, поэтому интересны юскейсы тех, кто трудится в кровавом энтерпрайзе с десятками версий/языков одного документационного портала
Если у вас так, то я бы всё-таки искал self-hosted вариант. Чтобы вы собирали на своём CI и хостили на своём сервере.
NV
И когда CI станет узким местом, вы в него просто докинете ресурсов или разделите документацию на куски поменьше.