Оформительство проектов и их содержательное качество
Эх, не хватает нашему брату-инженеру вот такой вот прыти... выдать фуфло за продукт первого сорта.
Зацените проектик, найденный в результате поисков софта для экспорта моделей из CAD в Gazebo. Данная реализация берёт подготовленные заранее(!) .stl, .obj, .mtl файлы и вставляет ссылки на них в подготовленный заранее(!) sdf. Там содержание в 20 строчках кода (больше времени уйдёт на разборы с окружением python), но только посмотрите на README! Сколько пафоса, картинок, лейблов и... инструкций для ручной работы. То есть вот автор натурально предлагает мне ради этих 20 строчек разбираться с его API командной строки! Видать, считает, что править в редакторе XML - это радикально сложнее, чем пользоваться его утилитой.
С одной стороны, бред, а с другой - учиться нам надо, учиться. Проекты Робосборщика - антипод этому; мы скрываем приличное содержание за скучным фасадом. При этом я не склонен требовать от инженеров быть хорошими оформителями, на то есть разделение труда и другие люди могут это выполнять гораздо быстрее и эффективнее. С другой - освоить это ремесло несложно, немного практики и данная культура становится автоматизмом, не требующим ментальных усилий. Да, поначалу будет казаться, что оформительство обкрадывает ценное время, которое можно было бы потратить на содержательную часть, но со временем это перестанет так казаться. Стоящие идеи вынашиваются годами, а оформляются за пару-тройку дней. Оформительство делает ваши идее слабее на жалкие доли процента. Ну, или сами идеи ничего не стоят.
Знаю точно, что без этой культуры в сложных проектах с большим количеством участников никуда. Либо это кто-то делает за Вас, при этом терзая Вас глупыми вопросами (и не занимаясь содержанием собственных идей), чтобы извлечь это содержание, либо знания о вашей идее всё-таки извлекаете Вы сами, а остальные постфактум помогают это изложить чуть красивее и яснее, а значит и понятнее. Не уверен, что первый вариант будет быстрее - в конце концов, накладные расходы на коммуникации тоже чего-то стоят.
Однако, есть и третий вариант - программа-оформитель, документацию к которой придётся-таки оформить :P
#open_source #docs
Эх, не хватает нашему брату-инженеру вот такой вот прыти... выдать фуфло за продукт первого сорта.
Зацените проектик, найденный в результате поисков софта для экспорта моделей из CAD в Gazebo. Данная реализация берёт подготовленные заранее(!) .stl, .obj, .mtl файлы и вставляет ссылки на них в подготовленный заранее(!) sdf. Там содержание в 20 строчках кода (больше времени уйдёт на разборы с окружением python), но только посмотрите на README! Сколько пафоса, картинок, лейблов и... инструкций для ручной работы. То есть вот автор натурально предлагает мне ради этих 20 строчек разбираться с его API командной строки! Видать, считает, что править в редакторе XML - это радикально сложнее, чем пользоваться его утилитой.
С одной стороны, бред, а с другой - учиться нам надо, учиться. Проекты Робосборщика - антипод этому; мы скрываем приличное содержание за скучным фасадом. При этом я не склонен требовать от инженеров быть хорошими оформителями, на то есть разделение труда и другие люди могут это выполнять гораздо быстрее и эффективнее. С другой - освоить это ремесло несложно, немного практики и данная культура становится автоматизмом, не требующим ментальных усилий. Да, поначалу будет казаться, что оформительство обкрадывает ценное время, которое можно было бы потратить на содержательную часть, но со временем это перестанет так казаться. Стоящие идеи вынашиваются годами, а оформляются за пару-тройку дней. Оформительство делает ваши идее слабее на жалкие доли процента. Ну, или сами идеи ничего не стоят.
Знаю точно, что без этой культуры в сложных проектах с большим количеством участников никуда. Либо это кто-то делает за Вас, при этом терзая Вас глупыми вопросами (и не занимаясь содержанием собственных идей), чтобы извлечь это содержание, либо знания о вашей идее всё-таки извлекаете Вы сами, а остальные постфактум помогают это изложить чуть красивее и яснее, а значит и понятнее. Не уверен, что первый вариант будет быстрее - в конце концов, накладные расходы на коммуникации тоже чего-то стоят.
Однако, есть и третий вариант - программа-оформитель, документацию к которой придётся-таки оформить :P
#open_source #docs
GitHub
GitHub - TurtleZhong/Gazebo-models-generator: A tool using to generate Gazebo models from 3D models.(Sketchup files, *.dae, *.obj…
A tool using to generate Gazebo models from 3D models.(Sketchup files, *.dae, *.obj, *.stl, etc.) - GitHub - TurtleZhong/Gazebo-models-generator: A tool using to generate Gazebo models from 3D mode...