Добро пожаловать в форум, Guest  >>   Войти | Регистрация | Поиск | Правила | В избранное | Подписаться
Все форумы / Firebird, InterBase Новый топик    Ответить
Топик располагается на нескольких страницах: Ctrl  назад   1 2 3 [4] 5 6 7   вперед  Ctrl      все
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Симонов Денис
Member

Откуда: Рязань
Сообщений: 9246
чччД
Имхо, несложно сделать указатель с полным перечнем ссылок на все слова руководства, а потом "вручную" отбросить лишние, но очень ли сие нужно? Я вот до сих пор его (указатель) даже и не замечал...


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

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

Вы не стесняйтесь предлагайте. Но только более конкретно по возможности.
4 фев 18, 12:59    [21164159]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
SQL2008
Member

Откуда:
Сообщений: 3703
Симонов Денис
SQL2008, предложения по существу нужны.

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

Предлагаю:
1. Cделать краткое описание всех ключевых слов.
2. Добавить в алфавитный указатель на все термины из п.2
4 фев 18, 13:06    [21164167]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
SQL2008
Member

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

Мне кажется, что русскоязычное название можно опустить.
4 фев 18, 13:09    [21164173]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
hvlad
Member

Откуда:
Сообщений: 10195
Симонов Денис
алфавитный указатель формируется по ключевым словам автоматически. Алфавитный указать сделан по операторам языка SQL
Так по ключевым словам или по операторам ? Очевидно же, что операторы есть подмножество ключевых слов...
4 фев 18, 13:27    [21164186]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
hvlad
Member

Откуда:
Сообщений: 10195
SQL2008
Но все равно считаю, что описание каждого ключевого слова, хотя бы краткое, должно быть в описании языка
Описание ? Серьёзно ? Какое описание у ключевого слова AND ?

Обычно в документации есть индекс всех ключевых слов, но не с описаниями, а с указателями на статьи, где данные слова встречаются.
4 фев 18, 13:29    [21164188]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Dimitry Sibiryakov
Member

Откуда:
Сообщений: 47080

Симонов Денис
Например добавить в алфавитный указатель основные термины помимо операторов языка.

Для этого обычно используют глоссарий, а не алфавитный указатель.

Posted via ActualForum NNTP Server 1.5

4 фев 18, 13:32    [21164193]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
SQL2008
Member

Откуда:
Сообщений: 3703
hvlad
Какое описание у ключевого слова AND ?

Оператор AND используется для составления условий в запросах, который отображает только те записи, когда первое и второе условие является правдой / true.
4 фев 18, 14:56    [21164317]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
SQL2008
Member

Откуда:
Сообщений: 3703
Вот как описан он в MS Transact SQL
4 фев 18, 15:00    [21164327]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
чччД
Guest
SQL2008,
ну и зачем нам это? Чтобы "освоить" очередной миллион долларов, которых разработчикам девать некуда? :)
Или таки находятся среди юзеров fb личности, страдающие от непонимания сути оператора AND?
4 фев 18, 15:10    [21164342]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Симонов Денис
Member

Откуда: Рязань
Сообщений: 9246
hvlad, SQL2008

под ключевыми словами я имел ввиду слова или предложения которые отображаются в алфавитном указателе, а не ключевые слова SQL. Я могу сделать их любыми по своему желанию.
4 фев 18, 15:35    [21164385]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
SQL2008
Member

Откуда:
Сообщений: 3703
чччД
ну и зачем нам это? Чтобы "освоить" очередной миллион долларов, которых разработчикам девать некуда? :)

Вы действительно считаете, что полнота документации это следствие освоения бюджета?

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

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

Я говорю вам о том, что документация должна быть полной и систематизированной.
Впрочем, можете со мной не соглашаться. Делайте как хотите.
4 фев 18, 16:02    [21164431]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
hvlad
Member

Откуда:
Сообщений: 10195
SQL2008
hvlad
Какое описание у ключевого слова AND ?

Оператор AND используется для составления условий в запросах, который отображает только те записи, когда первое и второе условие является правдой / true.
А ещё 100500 значений - где они ?
4 фев 18, 16:28    [21164476]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Dimitry Sibiryakov
Member

Откуда:
Сообщений: 47080

SQL2008
Вы действительно считаете, что полнота документации это следствие освоения бюджета?

Да.

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

Да.

Posted via ActualForum NNTP Server 1.5

4 фев 18, 16:49    [21164516]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Гаджимурадов Рустам
Member

Откуда:
Сообщений: 59631
SQL2008> Открыв документ я попытался найти описание того,
SQL2008> что называется DOMAIN, так как в SQL Server такого нет.
SQL2008> Но в алфавитном указателе ссылки на него не нашёл.

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


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

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

Posted via ActualForum NNTP Server 1.5

4 фев 18, 17:21    [21164568]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
SQL2008
Member

Откуда:
Сообщений: 3703
Гаджимурадов Рустам
SQL2008> Открыв документ я попытался найти описание того,
SQL2008> что называется DOMAIN, так как в SQL Server такого нет.
SQL2008> Но в алфавитном указателе ссылки на него не нашёл.

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


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

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


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

Это конечно крайность, но она показывает что есть настоящий перфекционизм.
Как я и сказал ранее, делайте так как считаете нужным.
Разве я против? Вместо того, чтобы сказать мне "мы тебя выслушали, но сделаем по своему" вы начинаете мне доказывать мою неправоту...
4 фев 18, 17:51    [21164597]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Симонов Денис
Member

Откуда: Рязань
Сообщений: 9246
SQL2008,

документы с пустыми главами могут быть, но только в черновиках. Руководство по языку SQL уже давно вышло из статуса черновика. Конечно там многое ещё можно улучшить, но им уже вполне можно пользоваться.
4 фев 18, 18:02    [21164613]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
чччД
Guest
SQL2008
...
Я говорю вам о том, что документация должна быть полной и систематизированной.
...

Слава Создателю, в ДАННОМ КОНКРЕТНОМ СЛУЧАЕ, документация должна быть всего лишь удобной для работы.

Если кто-то считает документацию недостаточно полной или "недостаточно чего-либо ещё", он может исправить ситуацию самостоятельно. Лицензия Firebird не запрещает это.
4 фев 18, 18:02    [21164614]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Симонов Денис
Member

Откуда: Рязань
Сообщений: 9246
чччД,

для начала можно попробовать убедить меня в необходимости таких изменений. Это довольно просто :)
4 фев 18, 18:04    [21164620]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Гаджимурадов Рустам
Member

Откуда:
Сообщений: 59631
Едва ли тут кто-то что-то тебе доказывает, тем более неправоту.
Скорее, объясняют - почему некоторые желания/запросы глупые
и/или как/где найти то, что ты ищешь. Я тебе даже больше скажу -
есть целые руководства (типы документов), которых у нас совсем
нет (пока) - и соотв. инфу приходится черпать из RN etc.

Posted via ActualForum NNTP Server 1.5

4 фев 18, 18:07    [21164627]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
чччД
Guest
Симонов Денис
чччД,

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


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

2. Всю работу можно проделать самостоятельно, с нуля: для бешеной собаки семь верст - не крюк.
4 фев 18, 18:07    [21164628]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Гаджимурадов Рустам
Member

Откуда:
Сообщений: 59631
Симонов Денис> для начала

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

Posted via ActualForum NNTP Server 1.5

4 фев 18, 18:08    [21164630]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Гаджимурадов Рустам
Member

Откуда:
Сообщений: 59631
чччД> 2. Всю работу можно проделать самостоятельно,
чччД> с нуля: для бешеной собаки семь верст - не крюк.

За 15 лет таких "бешеных собак" всего было человек 10, не более. :)

Posted via ActualForum NNTP Server 1.5

4 фев 18, 18:09    [21164633]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
чччД
Guest
Гаджимурадов Рустам,
главное - "можно". :)
4 фев 18, 18:16    [21164648]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
Симонов Денис
Member

Откуда: Рязань
Сообщений: 9246
чччД
2. Всю работу можно проделать самостоятельно, с нуля: для бешеной собаки семь верст - не крюк.


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

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


добавить пару слов в алфавитный указатель дело одного часа максимум. Вопрос только в том оправдано ли это. Добавить глоссарий уже сложнее, но тоже можно сделать вполне приемлемые сроки.
4 фев 18, 18:17    [21164649]     Ответить | Цитировать Сообщить модератору
 Re: Расскажите, чего вам не хватает в документации к FireBird 3.0*  [new]
чччД
Guest
Симонов Денис,

может, ну его, этот указатель?
Зачем заниматься гарантированно никому не нужной работой.
4 фев 18, 18:21    [21164659]     Ответить | Цитировать Сообщить модератору
Топик располагается на нескольких страницах: Ctrl  назад   1 2 3 [4] 5 6 7   вперед  Ctrl      все
Все форумы / Firebird, InterBase Ответить