Продолжаем лаконичную интерпретацию официальной документации Flutter в формате «вопрос-ответ». Вот уже 3-я часть, и она в большей степени будет полезна React Native-разработчикам. В данной интерпретации вы можете найти ответы на частые вопросы, а также определить для себя, сколько усилий нужно приложить, чтобы перейти с одного кроссплатформенного фреймворка на другой.
Рубрика «documentation» - 2
[По докам] Flutter. Часть 3. Для разработчиков React Native
2020-01-20 в 7:00, admin, рубрики: android, crossplatform, development, documentation, flutter, framework, iOS, javascript, ReactNative, Блог компании FunCorp, Разработка под android, разработка под iOS[По докам] Flutter. Часть 2. Для iOS разработчиков
2019-12-02 в 8:17, admin, рубрики: crossplatform, development, documentation, flutter, framework, iOS, Блог компании FunCorp, разработка мобильных приложений, разработка под iOSПосле длительного перерыва я продолжу рассказывать о популярном фреймворке Flutter в формате «вопрос — ответ». Первую статью для Android-разработчиков вы можете найти здесь, а сегодня будет полезный материал для разработчиков под iOS.
Если у вас мало времени для самостоятельного и глубокого изучения документации, но вы хотите понять, чем хорош Flutter и как его использовать, загляните под кат.
![[По докам] Flutter. Часть 2. Для iOS разработчиков - 1 [По докам] Flutter. Часть 2. Для iOS разработчиков - 1](https://www.pvsm.ru/images/2019/12/02/po-dokam-Flutter-chast-2-dlya-iOS-razrabotchikov.jpeg)
Flutter. Часть 1. Для Android-разработчиков
Flutter. Часть 2. Для iOS-разработчиков
Flutter. Часть 3. Для React-Native-разработчиков
Flutter. Часть 4. Для Web-разработчиков
Flutter. Часть 5. Для Xamarin.Forms-разработчиков
Читать полностью »
Docs as Code. Часть 1: автоматизируем обновление
2019-07-15 в 7:39, admin, рубрики: bitbucket, docker, docsascode, documentation, Jenkins, Блог компании Юла, Программирование, управление проектами, управление разработкой
В больших проектах, состоящих из десятков и сотен взаимодействующих сервисов, всё чаще становится обязательным подход к документации как к коду — docs as code.
Я покажу, как можно применять эту философию в реалиях classified-сервиса, а точнее, начну с первого этапа её внедрения: автоматизации обновления данных в документации.
Используйте GIT при документировании
2019-06-17 в 13:13, admin, рубрики: devops, documentation, Git, github, markdown, pandoc, pywin32, Системы управления версиями, управление проектамиИногда не только сама документация, но и процесс работы над ней может быть критичным. Например, в случае проектов львиная часть работы связана именно с подготовкой документации, и неправильный процесс может привести к ошибкам и даже к потере информации, а, следовательно, и к потере времени и выгоды. Но даже если эта тема и не является центральной в вашей работе и находится на периферии, то все равно правильный процесс может улучшить качество документа и сэкономить вам время.
Изложенный здесь подход, с примером конкретной реализации, имеет низкий порог вхождения. Технически, уже завтра вы можете начать работать по-новому.
Читать полностью »
[По докам] Flutter. Часть 1. Для Android разработчиков
2019-03-05 в 8:05, admin, рубрики: android, crossplatform, development, documentation, flutter, framework, Блог компании FunCorp, разработка мобильных приложений, Разработка под androidПро Flutter написано уже много статей. С каждым месяцем он становится всё популярнее. Поэтому я решил интерпретировать официальную документацию Flutter в лаконичный формат «вопрос — ответ». Думаю, многие, как и я, не имеют достаточно свободного времени для подробного изучения документации фреймворка, с которым они ещё не работают.
Если вы хотите понять, чем хорош этот фреймворк, и оценить, сколько усилий придётся приложить, чтобы его использовать — добро пожаловать под кат.
![[По докам] Flutter. Часть 1. Для Android разработчиков - 1 [По докам] Flutter. Часть 1. Для Android разработчиков - 1](https://www.pvsm.ru/images/2019/03/05/po-dokam-Flutter-chast-1-dlya-Android-razrabotchikov.jpg)
Новый взгляд на изучение и документирование исходного кода
2019-02-19 в 6:36, admin, рубрики: codebase, documentation, javascript, open source, php, python, web-разработка, Проектирование и рефакторингTL;DR Привет. Меня зовут Богдан и я изучаю проблемы чтения кода. Я только что закочнил первую рабочую версию «codecrumbs» — визуального инструмента для изучения исходного кода с помощью «хлебных крошек». Гитхаб репозиторий можно посмотреть тут.

Проблема
Недавно я проводил опрос о главных проблемах с которыми мы сталкиваемся когда начинаем изучать исходный код большого проекта (если вы ещё не участвовали, то пройти опрос всё ещё можно тут).
Читать полностью »
Swagger – умная документация вашего RESTful web-API — обзор Junior back-end developer-а для новичков
2018-12-29 в 12:44, admin, рубрики: api, C#, documentation, swagger, tutorial
Предисловие
Команда, в которой я сделала свои первые шаги на поприще написания промышленного кода, занималась разработкой удобного API к функциональности программного продукта на C# (для удобства назовем его, скажем, буквой E), существовавшего уже много лет и зарекомендовавшего себя на рынке с весьма положительной стороны. И здесь вроде бы у юного падавана пока не должно возникать вопросов, однако же представим себе, что ранее вы, скорей всего, конечно, писали собственные web-API, но вряд ли для широкой аудитории, а значит жили по принципу «Сам создал – сам пользуюсь», и если вдруг кого-то бы заинтересовала функциональность вашего API, то вы, наверное, кинули бы ему pdf-файл с подробной инструкцией (по крайней мере я бы сделала именно так). «Где посмотреть функционал апи» — спросила я тимлида ожидая получить ссылку на текстовый документ. «Загляни в Swagger» — ответил он.
Инструкции и полезная документация Check Point
2017-12-11 в 4:48, admin, рубрики: administration, check point, documentation, guides, Блог компании TS Solution, информационная безопасность, Сетевые технологии, системное администрирование
Относительно недавно мы публиковали статью “Какой firewall лучше всех? Лидеры среди UTM и Enterprise Firewalls (Gartner 2017)”. Безусловно, подобные сравнения очень важны и интересно знать лидеров рынка. Эта информация весьма полезна при выборе решения. Но большинство инженеров/сисадминов обращают внимание на еще один момент — документация. Чем больше документации и чем больше интернет-сообщество, тем проще администрировать выбранное решение. Как же обстоят дела с этим у Check Point? Ниже мы приведем наиболее полезные ресурсы Check Point, где вы сможете найти всю необходимую документацию или ответ на какой-либо технический вопрос. Эти ресурсы будут особенно полезны тем, кто уже использует Check Point.Читать полностью »
Вжух и готово — генерируем документацию из TypeScript кода с typedoc
2017-11-07 в 8:19, admin, рубрики: api, documentation, javascript, node.js, nodejs, reference, theme, typedoc, TypeScript, web, Блог компании ДоксВижн, Программирование, Разработка веб-сайтовВ этой статье я расскажу, как мы генерируем документацию из комментариев в коде TypeScript. В целом, все довольно просто, если требования простые. Впрочем, донастроить под себя тоже не очень трудно.
Что у нас получилось — можно посмотреть здесь.
Документирование #Микросервисов
2017-02-23 в 10:57, admin, рубрики: api, docker, documentation, java, Microservices, rest, swagger, Тестирование веб-сервисов
Оригнинальная статья является размышления на тему почему документация в мире микросервисов критично необходима и как ее можно создавать и публиковать используя swagger. Пошаговой инструкцией по настройке она точно не является.

![[По докам] Flutter. Часть 3. Для разработчиков React Native - 1 [По докам] Flutter. Часть 3. Для разработчиков React Native - 1](https://www.pvsm.ru/images/2020/01/20/po-dokam-Flutter-chast-3-dlya-razrabotchikov-React-Native.jpeg)
