Re: Ann: SWI-Prolog 7.1.5

On 01/17/2014 01:09 AM, Markus Triska wrote:
> Hi Jan,
>
> Jan Wielemaker <[email protected]> writes:
>
>>    - Quite a few changes in PlDoc to support the NEW WEBSITE!
>
> A few things I noticed on the new website:
>
> 1) On www.swi-prolog.org, there are now two "Search Documentation"
>     boxes, which behave differently:

If I understand this correctly, the bottom one just doesn't work. Fixed
that (wrong input field name). It calls the same handler as the top one,
so I'd expect it to behave the same now.

> 2) When I search for "transpose/2" in the upper box, I get predicate
>     descriptions of transpose/2, as intended. However, when I click on
>     "Show source", they point to library(simplex) instead of their
>     intended sources library(clpfd) and library(ugraphs).

transpose/2 is a bit of a mess.  There are two predicates using this
generic name, doing two totally different things.  Unfortunately, it
is very hard to extract the disambiguation information from the manual
as it stands.  This is an old issue.  It might get fixed at some point,
but if you want to get it fixed soon I'm afraid you'll have to come up
with a solution yourself ...

> 3) When I search for "transpose/2" in the lower box, it shows a page on
>     "How to use the search box".

= 1)

> 4) The overview of most important features which was available in the
>     previous website is no longer available. The previous version
>     mentioned for example the graphical tracer, the profiler, JIT
>     indexing etc. all on one single page. I think this kind of overview
>     is very valuable especially for new users and should be restored on
>     the main page or at least prominently linked to from the menu.

I must admit I was shocked to see all these features about which I care
having been removed from the home page. I quickly realised this was
mostly a good thing. No sane person is going to read all these things
from the home page. As it is now, it is is simple, shows the main
message and links quite clearly to most places you typically want to go.
Anne carefully analysed the site and user behaviour (notably search) to
organise the navigation of the home page. This should be completed with
suitable pages. As it stands, we quickly linked to the most relevant
pages that were already somewhere.

I think this information should return in `Is SWI-Prolog Right For My
Project?', directly or indirectly.

> 5) When I search for "clpfd" in the upper box, it finds a link to:
>     http://www.swi-prolog.org/pldoc/doc/swi/library/clp/clpfd.pl where
>     the CLP(FD) operators are shown in prefix instead of infix. It also
>     finds a link to http://www.swi-prolog.org/pldoc/man?section=clpfd,
>     where the operators are shown as intended (= infix). (The lower
>     search box again leads to "How to use the search box".)

The infix is quite likely a bug in PlDOc.  Same story as above ...

> 6) The link to the DCG tutorial does not work (leads to "Not Found").

Yip.  Should hopefully be fixed soon ...

> 7) The links in the pull-down menus change colour if I move the mouse
>     pointer over a rectangular sub-entry, suggesting I can click anywhere
>     within the rectangle to follow the link, yet it only works if I click
>     anywhere on the *text* instead of anywhere within the rectangle.\

Already noted.

	Cheers --- Jan