powered by simpleCommunicator - 2.0.51     © 2025 Programmizd 02
Форумы / Firebird, InterBase [игнор отключен] [закрыт для гостей] / Расскажите, чего вам не хватает в документации к FireBird 3.0*
25 сообщений из 171, страница 4 из 7
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596297
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
чччДИмхо, несложно сделать указатель с полным перечнем ссылок на все слова руководства, а потом "вручную" отбросить лишние, но очень ли сие нужно? Я вот до сих пор его (указатель) даже и не замечал...

на все нет никакого смысла, иначе указатель будет занимать столько же как сама документация. На основные понятия можно. Но тут надо подумать, что туда ещё включить. Пока там были только SQL операторы было понятно. Если включать что-то ещё, то надо подумать что именно.

TABLE, DOMAIN, VIEW, EXCEPTION, TRIGGER, PROCEDURE, FUNCTION, PACKAGE можно без проблем включить. Надо ли включать русскоязычное название этих объектов БД?

Вы не стесняйтесь предлагайте. Но только более конкретно по возможности.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596298
Фотография SQL2008
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов ДенисSQL2008, предложения по существу нужны.
Я понял. Но все равно считаю, что описание каждого ключевого слова, хотя бы краткое, должно быть в описании языка. Оно должно иметь исчерпывающую информацию независимо от уровня подготовки читателя.

Предлагаю:
1. Cделать краткое описание всех ключевых слов.
2. Добавить в алфавитный указатель на все термины из п.2
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596299
Фотография SQL2008
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов Денис TABLE, DOMAIN, VIEW, EXCEPTION, TRIGGER, PROCEDURE, FUNCTION, PACKAGE можно без проблем включить. Надо ли включать русскоязычное название этих объектов БД?
Мне кажется, что русскоязычное название можно опустить.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596303
hvlad
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов Денисалфавитный указатель формируется по ключевым словам автоматически. Алфавитный указать сделан по операторам языка SQLТак по ключевым словам или по операторам ? Очевидно же, что операторы есть подмножество ключевых слов...
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596304
hvlad
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
SQL2008Но все равно считаю, что описание каждого ключевого слова, хотя бы краткое, должно быть в описании языкаОписание ? Серьёзно ? Какое описание у ключевого слова AND ?

Обычно в документации есть индекс всех ключевых слов, но не с описаниями, а с указателями на статьи, где данные слова встречаются.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596308
Dimitry Sibiryakov
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов ДенисНапример добавить в алфавитный указатель основные термины помимо операторов языка.

Для этого обычно используют глоссарий, а не алфавитный указатель.
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596329
Фотография SQL2008
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hvlad Какое описание у ключевого слова AND ?
Оператор AND используется для составления условий в запросах, который отображает только те записи, когда первое и второе условие является правдой / true.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596331
Фотография SQL2008
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Вот как описан он в MS Transact SQL
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596334
чччД
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
SQL2008,
ну и зачем нам это? Чтобы "освоить" очередной миллион долларов, которых разработчикам девать некуда? :)
Или таки находятся среди юзеров fb личности, страдающие от непонимания сути оператора AND?
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596342
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
hvlad, SQL2008

под ключевыми словами я имел ввиду слова или предложения которые отображаются в алфавитном указателе, а не ключевые слова SQL. Я могу сделать их любыми по своему желанию.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596349
Фотография SQL2008
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
чччД ну и зачем нам это? Чтобы "освоить" очередной миллион долларов, которых разработчикам девать некуда? :)
Вы действительно считаете, что полнота документации это следствие освоения бюджета?

чччД Или таки находятся среди юзеров fb личности, страдающие от непонимания сути оператора AND?
А среди юзеров MS SQL Server таких личностей много?

Я говорю вам о том, что документация должна быть полной и систематизированной.
Впрочем, можете со мной не соглашаться. Делайте как хотите.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596357
hvlad
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
SQL2008hvlad Какое описание у ключевого слова AND ?
Оператор AND используется для составления условий в запросах, который отображает только те записи, когда первое и второе условие является правдой / true.А ещё 100500 значений - где они ?
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596362
Dimitry Sibiryakov
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
SQL2008Вы действительно считаете, что полнота документации это следствие освоения бюджета?

Да.

SQL2008А среди юзеров MS SQL Server таких личностей много?

Да.
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596379
Гаджимурадов Рустам
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
SQL2008> Открыв документ я попытался найти описание того,
SQL2008> что называется DOMAIN, так как в SQL Server такого нет.
SQL2008> Но в алфавитном указателе ссылки на него не нашёл.

Ты программист или где? Открой для себя сочетание клавиш Ctrl+F.
При чём ладно Domain, но там как уже упоминалось нет и Exception,
Table, View и ещё куча. Их ты тоже "не нашёл" ?


SQL2008> Если вы считаете, что это нормально

Да, более чем. Как максималист и перфекционист я предпочёл бы,
чтобы для Domain был соотв. подраздел Домены (Domains) в главе
"Типы данных", потому что связанной инфы (и перекрестных ссылок)
довольно много, но во-первых, это больше шашечки, а во-вторых,
это больше для книги/всеобъемлющей документации, коей LangRef,
в принципе, являться не обязан.
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596383
Фотография SQL2008
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Гаджимурадов РустамSQL2008> Открыв документ я попытался найти описание того,
SQL2008> что называется DOMAIN, так как в SQL Server такого нет.
SQL2008> Но в алфавитном указателе ссылки на него не нашёл.

Ты программист или где? Открой для себя сочетание клавиш Ctrl+F.
При чём ладно Domain, но там как уже упоминалось нет и Exception,
Table, View и ещё куча. Их ты тоже "не нашёл" ?


SQL2008> Если вы считаете, что это нормально

Да, более чем. Как максималист и перфекционист я предпочёл бы,
чтобы для Domain был соотв. подраздел Домены (Domains) в главе
"Типы данных", потому что связанной инфы (и перекрестных ссылок)
довольно много, но во-первых, это больше шашечки, а во-вторых,
это больше для книги/всеобъемлющей документации, коей LangRef,
в принципе, являться не обязан.

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

Это конечно крайность, но она показывает что есть настоящий перфекционизм.
Как я и сказал ранее, делайте так как считаете нужным.
Разве я против? Вместо того, чтобы сказать мне "мы тебя выслушали, но сделаем по своему" вы начинаете мне доказывать мою неправоту...
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596384
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
SQL2008,

документы с пустыми главами могут быть, но только в черновиках. Руководство по языку SQL уже давно вышло из статуса черновика. Конечно там многое ещё можно улучшить, но им уже вполне можно пользоваться.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596385
чччД
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
SQL2008...
Я говорю вам о том, что документация должна быть полной и систематизированной.
...
Слава Создателю, в ДАННОМ КОНКРЕТНОМ СЛУЧАЕ, документация должна быть всего лишь удобной для работы.

Если кто-то считает документацию недостаточно полной или "недостаточно чего-либо ещё", он может исправить ситуацию самостоятельно. Лицензия Firebird не запрещает это.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596386
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
чччД,

для начала можно попробовать убедить меня в необходимости таких изменений. Это довольно просто :)
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596387
Гаджимурадов Рустам
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Едва ли тут кто-то что-то тебе доказывает, тем более неправоту.
Скорее, объясняют - почему некоторые желания/запросы глупые
и/или как/где найти то, что ты ищешь. Я тебе даже больше скажу -
есть целые руководства (типы документов), которых у нас совсем
нет (пока) - и соотв. инфу приходится черпать из RN etc.
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596388
чччД
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов ДенисчччД,

для начала можно попробовать убедить меня в необходимости таких изменений. Это довольно просто :)

1.Тебе можно подкупить.

2. Всю работу можно проделать самостоятельно, с нуля: для бешеной собаки семь верст - не крюк.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596389
Гаджимурадов Рустам
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов Денис> для начала

Ой-ой-ой... Спустись на Землю. :) От подобного начала до результата - как до звезды. :)
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596390
Гаджимурадов Рустам
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
чччД> 2. Всю работу можно проделать самостоятельно,
чччД> с нуля: для бешеной собаки семь верст - не крюк.

За 15 лет таких "бешеных собак" всего было человек 10, не более. :)
Posted via ActualForum NNTP Server 1.5
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596393
чччД
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Гаджимурадов Рустам,
главное - "можно". :)
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596394
Фотография Симонов Денис
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
чччД2. Всю работу можно проделать самостоятельно, с нуля: для бешеной собаки семь верст - не крюк.

ну вообще-то я эту работу делал не один. Сейчас занимаюсь поддержкой LangRef. Небольшие изменения вполне могу сделать самостоятельно.

Гаджимурадов РустамОй-ой-ой... Спустись на Землю. :) От подобного начала до результата - как до звезды. :)

добавить пару слов в алфавитный указатель дело одного часа максимум. Вопрос только в том оправдано ли это. Добавить глоссарий уже сложнее, но тоже можно сделать вполне приемлемые сроки.
...
Рейтинг: 0 / 0
Расскажите, чего вам не хватает в документации к FireBird 3.0*
    #39596396
чччД
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Участник
Симонов Денис,

может, ну его, этот указатель?
Зачем заниматься гарантированно никому не нужной работой.
...
Рейтинг: 0 / 0
25 сообщений из 171, страница 4 из 7
Форумы / Firebird, InterBase [игнор отключен] [закрыт для гостей] / Расскажите, чего вам не хватает в документации к FireBird 3.0*
Целевая тема:
Создать новую тему:
Автор:
Закрыть
Цитировать
Найденые пользователи ...
Разблокировать пользователей ...
Читали форум (0):
Пользователи онлайн (0):
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]