On Fri, Feb 7, 2014 at 1:19 PM, Dimitry Sibiryakov <sd@...> wrote:

> Is it really too hard to look for SQL syntax in Language Reference?..

Not for me or you. We know to start looking there. But how the average
Joe is going to do it - let's try it with me the happy case:
1. Go to firebirdsql.org.
2. Click the "Documentation".
3. Take a lucky guess and choose "Reference Manuals". [problem #1]
4. Whoa, that's a lot of links. "QSG" that's probably not it - I need
pure reference docs. Keep scrolling. Scrolling. [problem #2]
5. There it is "Firebird 2.5 Language Reference Update".

That's IMHO a lot of clicks and having where to go.

Also it looks different than the original site (confusing). If you
click "Firebird Documentation Index" you get to top level (different
look again) and you can start digging again (what if you landed from
search engine?; not mentioning the LR is for 2.0, 2.1, 2.5 - confusing
for search engines and people as well). And it's not easily searchable
within the site.

I'm *not* saying that the documentation is wrong or people working on
it are doing bad job. Quite the opposite. It's just not close to hands
(or keyboard ;)) of average Joe.

--
Jiri {x2} Cincura (x2develop.com founder)
http://blog.cincura.net/ | http://www.ID3renamer.com