Review: Needs Fixing

I have managed to create the documentation and the generation is very quick 
(even after you add all the functionality I still think it will be quicker than 
the old one).

I would have some remarks though:

1) the menu on the left in the modules.html page is broken:
here is what I get:

All 'excel' links point to the
module documentation.
Both cryptography links point to
and so on.

2) there is no page with all the functions that helps the user find a function 
by name
(please see function_index.html)

3) in the 'Namespaces' section: please make the namespaces links to the module 
documentation where this is possible
(for instance should be a link to the EXPath Zorba 
module documentation)

4.1) in the 'Function Summary' please put back the hover text such that people 
know what is the connection between the pictures and function annotations
('S' means sequential, 'E' external and so on)

4.2) Also the pictures should be links pointing to the specs: for instance 
'external' should point to 
and so on.
That is because not all the annotations come from W3C, there are also Zorba 
ones like 'scripting' that has to point to doc/zorba/html/scripting_spec.html.

4.3) put back the pictures in the function description. Example:
instead of 
E S append-binary#2

5.1) there is no link to the actual XQuery module with a nice XQuery 
This does not help for the external functions but it shows the actual 
implementation for the XQuery functions.

5.2) there is no links to the schemas with a nice XML highlighting

6) there are no examples

7.1) there is a bug in the 'Errors' section:
Please see for example append-binary#2:

    file:FOFL0004 If
    points to a directory.
    file:FOFL9999 If any other error occurs.

Instead of:
    file:FOFL0004 If <strong>$file</strong> points to a directory.
    file:FOFL9999 If any other error occurs.

7.2) same error is in the description of each function:
Please see append#3 function description.

8.1) the links to the Zorba documentation are broken.
See for instance and in the module 
description the link to the URI resolvers points to:
instead of:

8.2) the links to the FLWOR Foundation site and Apache from the bottom of the 
pages point to nowhere.
I'm reffering to the part:  
Zorba is supported by the FLWOR Foundation and distributed under Apache 
Licence, Version 2.0.

8.3) please run the web-crawler that checks there are no broken links in the 
generated documentation
Your team Zorba Coders is subscribed to branch lp:zorba.

Mailing list:
Post to     :
Unsubscribe :
More help   :

Reply via email to