LINUX.ORG.RU

Инструменты для создания профессиональной документации в Linux


0

0

Создание документации на программное обеспечение было, есть и будет подводным камнем разработки. У многих могло сложиться впечатление, что эта проблема в Linux стоит особенно остро. Однако, несмотря на отсутствие в Linux стандартных инструментов документирования, таких как FrameMaker, RoboHelp и WebWorks Publisher, эта среда не менее удобна для создания технической документации, чем Windows.

>>> Подробности

★★★★★

Проверено: Shaman007 ()

С чего бы вдруг были проблемы с документацией под ленух? Гм гм... сначала даем спорное утверждение, а потом с доблестью разбираемся с проблемами? Похоже на гнусный пиар. Только не понятно чего. Статьи? RoboHelp'а? Других комерческих тулзов?

eXOR ★★★★★
()
Ответ на: комментарий от anonymous

Тоже не понятно где проблемы, man пользуют все, pydoc вообще отличная штука. Доки по инсталяции в latex. У кого собственно проблемы?

anonymous
()

Вызывающе неверная информация.

> У многих могло сложиться впечатление, что эта проблема в Linux стоит особенно остро.

У многих ли? Могло ли?

Camel ★★★★★
()

Похоже на дешовый пиар статьи...

Ant0
()

Народ, по ссылке сходить сто лет как никто не просит - но хоть в новость вчитайтесь, проблема в том, что впадлу доки писать.

Правда сама новость видать женщиной писалась - каким макаром из упомянутого следует "удобство" и какие телодвижения должны последовать - хз.

Gharik
()
Ответ на: комментарий от Gharik

а может то вообще блондинка была :-?

следует запретить женщинам пользоваться Линукс! чтоб не оскверняли святыню, так сказать! =)

anonymous
()

В _переводе_ статьи есть и про DocBook... Но сама новость ниочем. Те кому нужно создание профессиональной документации в *nix уже давно (imho) знают о DocBook, LaTeX и др *удобных* инструментах.

Ну а проверял как всегда шаман...

Killy
()
Ответ на: комментарий от anonymous

Ну если техписы с венды слезут, то оной точно капец :)

anonymous
()
Ответ на: комментарий от eXOR

Нет единого источника документации. Далеко не всё нормально документировано. Часто при использовании дистра доки на юзеровский софт просто отсутсвуют. Это скорее проблема культуры разработчиков софта и разработчиков дистров.

binr ★★
()
Ответ на: комментарий от binr

> Это скорее проблема культуры разработчиков софта и разработчиков дистров.

Вполне логично. Ведь при разработке коммерческого софта за написание документации деньги платят. А при разработке свободного софта (и при составлении дистрибов) - всем в лом.

anonymous
()
Ответ на: комментарий от george_root

>проблемы с документацией у того кто не умеет читать?

Порой не только это.. Проблемы с документацией бывают и от того, что кто-то не умеет писать..

My_quest ★★★★★
()
Ответ на: комментарий от anonymous

Линупсойды, а теперь сходите на openbsd.org и сравните свои линуксячьи маны.
У вас проблемы..

anonymous
()
Ответ на: комментарий от watashiwa_daredeska

>> Какие проблемы у DocBook?

>XML

А у тебя аллергия? Начинаешь чесаться и пукать?

r ★★★★★
()

Почитав статью, хотя читать там особенно-то и нечего, так и не понял, чем профессиональная документация отличается от непрофессиональной, что нужно сделать, чтобы она стала профессиональной. Неужели достаточно скопипастить её из непрофессионального средства создания в "профессиональное"... :)

Lumi ★★★★★
()

Ну статейка для переходящих с оффтопика. Из серии "часто нужно редактировать изображения. У многих могло сложиться впечатление, что эта проблема в Linux стоит особенно остро. Однако, несмотря на отсутствие в Linux стандартных инструментов, таких как Photoshop, Illustrator, Visio, Corel Draw!, эта среда не менее удобна для работы с изображениями, чем Windows."

Обзор тулзов, вроде, здравый, хотя некоторые коммерческие инструменты не перечислены (у нас вот писатели пользуются Syntext Serna)- но зачем было это постить как новость - непонятно...

anonymous
()

$1 было, есть и будет подводным камнем $2. У многих могло сложиться впечатление, что эта проблема в Linux стоит особенно остро. Однако, несмотря на отсутствие в Linux стандартных инструментов $1, таких как $3, эта среда не менее удобна для $1, чем Windows.

anonymous
()

Странно, что про inkscape не написали.

Davidov ★★★★
()

>стандартных инструментов документирования, таких как FrameMaker, RoboHelp и WebWorks Publisher

Пожалуйста ссылку на стандарт в студию.

capricorn20
()

Блин, ну вы даёте... Опубликовать русский перевод статьи, которой почти год от роду и дать новость на лоре... Не говоря уж о том, что перевод небезупречен. Плюс ко всему, нет ни слова о современных тенденциях типа использования вики.

> Для создания иллюстраций и схем можно воспользоваться Sodipodi,

А для написания текста пользоваться Word 1.0 в dosemu, ага.

> Однако они вполне уместны, когда речь заходит о небольших текстах, которые время от времени приходится писать каждому документалисту,

Дядя что-то не в теме. Большинство техписов из ворда вообще не вылазит.

AP ★★★★★
()
Ответ на: комментарий от AP

> Дядя что-то не в теме.

Дядя, как раз в теме.

> Большинство техписов из ворда вообще не вылазит.

Откуда дровишки?

kda ★★★★★
() автор топика
Ответ на: комментарий от Gharik

>проблема в том, что впадлу доки писать

И чего? Уже несколько лет на DocBook переходят - пишется автоматом.

jackill ★★★★★
()
Ответ на: комментарий от watashiwa_daredeska

>XML

Его можно перегенерить в html и pdf и даже при определенной сноровке запихать в wiki.

Это удобно.

jackill ★★★★★
()
Ответ на: комментарий от kda

> Откуда дровишки?

Из личного профессионального опыта :)

AP ★★★★★
()
Ответ на: комментарий от AP

> Большинство техписов из ворда вообще не вылазит.

Это очень плохие техписы. Они пишут очень плохую документацию. Нельзя ориентироваться на большинство, большинство работать не умеет.

anonymous
()
Ответ на: комментарий от rcr_cremator

>собственно где doxygen? Вроде там упомянут.

Ну статья так себе, америкосом или кем там писаная. Но зато хоть есть теперь куда сослаться, а то про доку в линухе на русском только по кусочкам. Без Incscape'а обзор несколько странный, и про Серну в контексте DocBook'а тоже странно не упомянуто. В общем, полезно, но неполно.

anonymous
()
Ответ на: комментарий от jackill

> Его можно перегенерить в html и pdf

Еще бы его в html и pdf нельзя было, о чем бы тогда разговор?

> и даже при определенной сноровке запихать в wiki

Не вижу особого смысла в DocBook->wiki, если нет wiki->DocBook и есть DocBook->html.

Но это всё фигня. Хреновость в том, что XML этот поганый руками геморно писать. А в "специализированных средствах" для ковыряния XML дюже поганые редакторы текста. Хотя, смотрел на них давно, может чего изменилось, однако сильно сомневаюсь. Что сейчас стоит посмотреть для работы с XML?

А в чем, собственно, примущества DocBook перед, скажем, texinfo, zoem?

watashiwa_daredeska ★★★★
()
Ответ на: комментарий от anonymous

>> Большинство техписов из ворда вообще не вылазит.

> Это очень плохие техписы. Они пишут очень плохую документацию.

Сомневаюсь, что Вы можете об этом судить :)

AP ★★★★★
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.