Подтвердить что ты не робот

Ссылка "Лучше Boost"?

То, что действительно меня отключает, - это их документация. Мне нужна хорошая рекомендация, и вместо того, чтобы объяснить, какая хорошая ссылка для меня, я приведу пример:

java.sun.com/javase/6/docs/api/ Да, я люблю это. Это также: cppreference.com/wiki/stl/vector/start

С другой стороны, то, что я нахожу в boost, выглядит примерно так: http://www.boost.org/doc/libs/1_40_0/libs/smart_ptr/shared_ptr.htm

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

Если вы не нашли разницы между этим и приведенными выше примерами, остановите чтение и проигнорируйте это сообщение. Не поймите меня неправильно, я пишу С++, и я использую Boost. В моей фирме мы используем по крайней мере 4 из их библиотек, все еще каждый раз, когда мне нужно проверить прототип метода, например, он выводит меня из моих нервов, прокручивая их эссе. И да, я знаю, что Boost - это совлокальный проект, и разные библиотеки разрабатываются разными командами.

Итак, кто-то из вас разделяет мое разочарование ссылкой на Boost, и знаете ли вы, что сайт лучше документирует библиотеки Boost?

4b9b3361

Ответ 1

В общем, я не считаю, что документация плохая. В общем, информация там "где-то". Основная проблема, которую я вижу, - это отсутствие единообразия, затрудняющее ее "где-то". Когда вы пишете в своем вопросе, документы были написаны разными людьми, и в другое время, и это, вероятно, причина для этого отсутствия общей структуры.

Из ссылок java и cppreference, которые вы приводите в примере, я полагаю, что вас больше интересует краткий обзор интерфейса, чем в материалах "учебник" или "мотивация". Для shared_ptr http://www.boost.org/doc/libs/1_40_0/libs/smart_ptr/shared_ptr.htm#Synopsis предоставить то, что вам нужно?

Для некоторых libs полезно использовать "тестовые" и "примерные" каталоги в разделе libs/<library_name>.

Вы можете размещать свои вопросы, комментарии и предложения по ускорению users и/или документация списки рассылки. Из того, что я вижу там, рекомендации по улучшению документации обычно приветствуются поддерживающими библиотеку.

Ответ 2

Если вы ищете вводный текст, я нашел книгу Бьерна Карлссона очень хорошей. Это было давно, когда я прочитал его, чтобы в настоящее время доступны более современные тексты. Найти здесь.

Ответ 3

Я определенно согласен. Джавадок - противный, противный материал. Но он является основательным и последовательным в почти каждом проекте. Сравните возможность просмотра случайной проектной документации Jakarta с информацией о случайном проекте Boost.

Ответ 4

Глядя на предоставленную ссылку Java, более половины ее устарело уже довольно давно:)

Теперь у вас есть инструменты PDF и формат PDF документов. Есть инструменты и многое другое на своем пути: от boostbook для писателей-библиотек давным-давно в резюме и т.д. Создайте свой собственный или проанализируйте существующее большинство разметки на уже раздутый проект:)