Здесь приведён список проектов, которые находятся в работе (или - активно обсуждаются в списке рассылки freebsd-doc). Также сюда - включены некоторые проекты, которые еще не обсуждались, но воплотить - их было бы хорошей идеей. У каждого проекта есть человек для контактов - (если он известен).
+ активно обсуждаются в списке рассылки freebsd-doc).Если вы думаете, что сможете принять участие в любом из этих проектов, не стесняйтесь заявить об этом. Поговорите с человеком, отвечающим за конкретный проект, и он поможет вам стать его участником. Если у вас есть какие-либо идеи относительно новых проектов, пожалуйста, отправьте письмо по адресу FreeBSD-doc@FreeBSD.org.
TODO список для документации - это + постоянно обновляющийся список проблем с документацией, которые должны + быть решены. Этот список ежемесячно отсылается в список рассылки FreeBSD-doc@FreeBSD.org. + Если вы хотите помочь нам улучшить документацию FreeBSD, то в первую + вы должны выбрать пункт из этого списка.
Текущие сообщения об ошибках в документации отслеживаются с помощью базы данных GNATS. Вы можете просмотреть открытые сообщения об ошибках в документации.
- -Ответственный: - Мюррей Стокели <murray@FreeBSD.org>
- -Описание: - Этот проект завершён. 3-е издание Руководства FreeBSD теперь можно - приобрести в виде комплекта из двух томов в компании The FreeBSD Mall. Том - 1 ISBN: 1-57176-327-9, Том 2 ISBN: 1-57176-328-7.
- -Список задач, который мы использовали при подготовке этой книги, - остаётся доступным здесь для потомков.
- -Список задач проекта во второму изданию также остаётся доступным здесь. Объём второго издания книги составляет - 653 страниц, его номер ISBN 1-57176-303-1. Спасибо всем, кто принял в - нём участие. Полный анонс можно прочесть - здесь.
- -Ответственный: FreeBSD-doc < FreeBSD-doc@FreeBSD.org>
Описание: В Руководстве FreeBSD было добавлено много новых разделов без тематических указателей, другие были добавлены с несоответствующими первичными или вторичными ключами индексации, которые не подходят в существующую схему. Некоторые тематические указатели добавлялись внутри списков или других областях текста, где их использование в соответствии с применяемыми нами таблицами стилей не - разрешается. Это приводит к появлению символов '???' вместо реальных + разрешается. Это приводит к появлению символов ??? вместо реальных номеров страниц при выдаче индексного указатели на печать.
Работа с указателями требует опыта и всякому, работающему над этой проблемой, настоятельно рекомендуется тщательно прочесть имеющийся указатель (готовый к выдаче на печать) одновременно с книгой Chicago Manual of Style или другим документом, описывающим стилистику и, кроме всего прочего, тематические указатели. Пожалуйста, просмотрите журнал CVS некоторых файлов chapter.sgml, чтобы проанализировать некоторые прошлые уже исправленные ошибки индексации. Работать после внесения любых изменений в указатели в обязательном порядке нужно с версией Руководства в формате PostScript, так как многие ошибки, такие как длинные слова или указатели с большим уровнем вложения будут отрицательно сказываться на используемую здесь выдачу в две колонки, - либо будут приводить в выдаче номеров страниц в виде '???'.
+ либо будут приводить в выдаче номеров страниц в виде ???.Имеется скрипт doc/share/misc/indexreport.pl, который может использоваться для выявления областей SGML-файла, в котором метки <indexterm> встречаются редко.
- - -Ответственный: FreeBSD-doc <FreeBSD-doc@FreeBSD.org>
- -Описание: В Руководство FreeBSD недавно была добавлена глава о - сетевых экранах. Это новое добавление по большей части является - незаконченной работой, в нём присутствует много грамматических и - оформительских недочётов. Ранее эта глава являлась большой частью - главы об информационной безопасности, так что пожалуйста, обратитесь к - CVS-журналу security/chapter.sgml, чтобы просмотреть те работы, - которые были выполнены в течение последних месяцев, чтобы сделать этот - раздел более соответствующим Учебнику по Проекту документирования и - набору остальных наших документов. Предстоит выполнить ещё много - работы, и любая помощь будет принята.
- - - -Ответственный: FreeBSD-www < - FreeBSD-www@FreeBSD.org>
- -Описание: Web-сайт FreeBSD.org большей частью написан на HTML - 3.2. Некоторые составляющие его файлы технически были обновлены для - использования HTML 4 DTD, но по духу они остаются файлами стандарта - HTML 3.2 с чрезвычайно слабым использованием CSS и значительным - применением жёстко заданных меток, определяющих внешний вид.
- -Любой пересмотр дизайна Web-сайта FreeBSD.org будет в большей мере - основан на CSS. Перевод существующих страниц на использование CSS - позволяет нам быстрее изменять внешний вид и общий дизайн Web-сайта в - целом, а также снизить требования к пропускной способности. Как и для - DocBook, используемом для написания нашей технической документации, - современные стандарты CSS и HTML позволяют нам отделить внешний вид от - данных, и мы должны лучше учитывать эти особенности при создании нашего - Web-сайта.
-Ответственный: FreeBSD-doc <FreeBSD-doc@FreeBSD.org>, Мюррей Стокели <murray@FreeBSD.org>
Описание: К набору документации в каталоге doc/en_US.ISO8859-1/slides недавно были добавлены презентации, размеченные в формате DocBook-slides DTD. Нам нужны дополнительные презентационные материалы, необходима доработка таблиц стилей для формирования контента из замечаний к релизам и других XML-источников в нашем наборе документации для обновления и построения слайдов по команде 'make'. Пример простой презентации с некоторой такой функциональностью уже был создан, но работа должна продолжаться! Кроме того, таблицы стилей для выдачи на печать и в формате PDF (использующие XSLT-процессоры на основе Java, возможности PassiveTeX для слайдов слишком ограничены) могут быть улучшены, так как таблицы стилей DocBook Slides XSL-FO генерируют для слайдов весьма спартанское оформление.
Ответственный: FreeBSD-doc <FreeBSD-doc@FreeBSD.org>
Описание: Пользователи, переходящие от Linux к FreeBSD, могут столкнуться с некоторыми различиями между системами (различные командные процессоры, используемые по умолчанию, конфигурирование системы при загрузке и т.д.).
Ответственный: Никто
Описание: Части FAQ и Руководства имеют пустые разделы. Их требуется заполнить. Если вы использовали какие-либо из этих документов и нашли их неполными, пожалуйста, найдите время для описания вашего опыта в качестве возможной замены.
Кроме того, если вы сделали что-то, что не описано в FAQ или Руководстве, просто напишите новый раздел. Затем пошлите его так, как описано выше.
Ответственный: <doc@FreeBSD.org>, <scsi@FreeBSD.org>
Описание: Посмотрите первый вариант Архитектура и реализация подсистемы SCSI во FreeBSD.
- -Ответственный: - <doc@FreeBSD.org>
- -Описание:
-Ответственный: <doc@FreeBSD.org>, Wolfram Schneider <wosch@FreeBSD.org>
Описание: Изменение CGI скриптов url.cgi, ports.cgi, pds.cgi и скрипта portindex с использованием Perl модулей FreeBSD::Ports modules. Эти модули также нуждаются в тестировании.
Ответственный: <doc@FreeBSD.org>
Описание:
Наши основные страницы Web-сервера написаны на (американском) английском. Проект FreeBSD Translations Projects занимается переводом страниц Web-сервера, Руководства и FAQ на другие языки.
Мы должны перевести скрипты cgi, а также и скрипты для построения Web-страниц. Скрипты должны поддерживать несколько языков, а не только один. Большинство скриптов написано на языке perl.
Ответственный: <doc@FreeBSD.org>
Перевод документации FreeBSD (Web-страницы, FAQ, Руководство, страницы справочника) на другие языки. Обратитесь к проектам перевода FreeBSD
Ответственный: Eric Anderson <anderson@centtech.com>
При поиске по Web-серверу выводимый текст включает имя файла, который были найден, например, FAQ34.html.
Будет более удобно, если в результат поиска будет включен и запрашиваемый текст, что позволит пользователю увидеть, насколько результат поиска соответствует запросу.
- -Ответственный: - Tom Rhodes <trhodes@FreeBSD.org>
- -Многие параметры настройки FreeBSD не документированы. Каждый знает, - насколько сложным может быть использование недокументированной системы, - поэтому и был организован этот проект. Основная его цель это создание - инструмента, способного генерировать страницу справочника с параметрами - настройки. Следовательно, нам потребуется создать этот список из - исходного кода.
- - -Ответственный: - Tom Rhodes <trhodes@FreeBSD.org> - и Hiten Pandya <hmp@FreeBSD.org>
- -Описание: Документирование интерфейсов и функций ядра.
- - -Описание: Написание страниц справочника раздела 4.
- -У всех драйверов в FreeBSD должны быть страницы справочника - в разделе 4, но некоторых страниц нет.
- -| Задача | -Описание | -Ответственный | -Последнее обновление | -Состояние | -
|---|---|---|---|---|
| Новые страницы справочника раздела 4 | -||||
| bs(4) | -драйвер WD33C93 SCSI | -- | 7 ноября 2003 | -&status.new; | -
| cm(4) | -сетевые адаптеры SMC Arcnet | -&a.trhodes; | -21 июня 2004 | -&status.done; | -
| cnw(4) | -Адаптер беспроводной сети NetWave AirSurfer | -&a.brueffer; | -10 сентября 2004 | -&status.done; | -
| ct(4) | -основанный на WD33C93 драйвер SCSI | -&a.non; | -21 ноября 2003 | -&status.wip; | -
| digi(4) | -драйвер интеллектуального коммуникационного адаптера DigiBoard | -XXX | -7 декабря 2003 | -&status.done; | -
| emu10k1(4) | -драйвер Soundblaster Pro | -&a.trhodes;, &a.hmp; | -7 ноября 2003 | -&status.done; | -
| esp(4) | -SCSI-контроллер QLogic (?), имеющийся в машинах Sun | -&a.trhodes; | -21 июня 2004 | -&status.done; | -
| hfa(4) | -драйвер HARP ATM | -&a.trhodes; | -6 августа 2004 | -&status.done; | -
| idt(4) | -NICStar ATM Adapter | -&a.trhodes;, &a.bms; | -9 ноября 2003 | -&status.done; | -
| ips(4) | -контроллер IBM/Adaptec ServerRAID | -&a.trhodes; | -11 ноября 2003 | -&status.done; | -
| mss(4) | -AD1848-совместимый драйвер MSS/WSS | -- | 7 ноября 2003 | -&status.new; | -
| ncv(4) | -драйвер NCR 53C500 SCSI (PC-98) | -&a.trhodes; | -20 ноября 2003 | -&status.done; | -
| nsp(4) | -драйвер Workbit Ninja SCSI (PC-98) | -&a.non; | -24 ноября 2003 | -&status.done; | -
| nss(4) | -поддержка звука NEC PC-98 | -- | 7 ноября 2003 | -&status.new; | -
| ofwcons(4) | -IEEE-1275 / Open Firmware | -- | 7 ноября 2003 | -&status.new; | -
| rc(4) | -драйвер коммуникационного мультиплексора Riscom/8 | -&a.trhodes; | -21 июня 2004 | -&status.done; | -
| sab(4) | -драйвер SAB82523 Dual UART | -&a.bms; | -6 декабря 2003 | -&status.done; | -
| snc(4) | -драйвер сетевого адаптера Nat. Semi. DP8393X | -&a.trhodes; | -21 июня 2004 | -&status.done; | -
| uaudio(4) | -драйвер USB Audio | -&a.hmp; | -10 ноября 2003 | -&status.done; | -
| wdc(4) | -- | &a.rushani; | -8 ноября 2003 | -&status.done; | -
| wds(4) | -SCSI-драйвер WD7000 | -- | 24 августа 2004 | -&status.new; | -
| xrpu(4) | -драйвер Xilinx FPGA/RPU | -- | 7 ноября 2003 | -&status.new; | -
| zs(4) | -драйвер Zilog UART | -- | 7 ноября 2003 | -&status.new; | -
| Обозначения | -|
|---|---|
| &status.new; | -Ещё не начата | -
| &status.blocked; | -Заблокирована в ожидании завершения другой задачи | -
| &status.wip; | -В работе | -
| &status.done; | -Задача завершена | -
| &status.n-a; | -Не запланирована | -