[ZDP] Congratulations, nitpicking and suggestions

[Alexandre Ratti]

Hello ZDPists,


First of all, congratulations for the news ZDP site. I just had a look at 
the home page and I think it is great.

I like the link items in the FAQ system, too: that's very useful to point 
new users to in-depth documentation.


And now, nitpicking :-) : (And suggestions).

- On the <http://zdp.zope.org/members/teyc> page, when clicking on the 
"Chui Tey is Maintainer of ..." link, I get a long list of objets 
maintained by Maik. This isn't what I expected.

- On the <http://zdp.zope.org/projects/zfaq/faq/DTML> page, the page 
display is too wide. This will be a problem for people using low-resolution 
display.
Also, the page doesn't print properly on A4 (standard European) paper. I 
think this is caused by the PRE formatting for code examples, which 
prevents wrapping.
One solution is to provide a "printable page" alternate layout where the 
left-side link column isn't included.

- In the Add FAQ Question / Answers forms, have you considered adding a 
select list to pick keywords or subsection titles? This would allow to 
refine searching or to group questions in a section such as DTML.
What I mean is that eventually many questions and answers may be related to 
say the tree tag. Providing a way to group them could turn out to be useful.

- I tried creating a new FAQ section. In the 
<http://zdp.zope.org/projects/zfaq/faq/manage_addProduct/DocumentFolderProdu 
ct/FAQSectionClass_factory> page, the purpose of the "FAQ Section content:" 
field was unclear to me. I expected  a FAQ section to be a holder for FAQ 
Questions and Answers objects, so I couldn't see why content was needed. 
Then I realised the text appears at the beginning of the page. This could 
be explained in the Add Section form. Example: "This explanatory text will 
be displayed at the top of the section page, before questions and answers 
are listed."

- Also, I goofed: I failed to provide a number in front of the FAQ Section 
name ("ZClasses") because I expected it to be automatically generated. 
Manual numbers do make sense because you can use them to sort the section 
titles in a natural way (so that Zope Installation is listed before Zope 
API for instance).
You may want to specify in the Add Section form that a number is needed. 
(Or did I miss the explaination?).
=> How can I edit this section name to correct my mistake? Can you grand me 
access?

- I added a FAQ Question and a FAQ Answer in the new ZClasses section. When 
adding the answer I noticed that available answers are not listed in the 
Question view (<http://zdp.zope.org/projects/zfaq/faq/ZClasses/952341720>). 
The downside is that when you are viewing a question you have no way to 
know that it has been answered already.

- How can I add a link ? I'd like to add a link near the answer to the 
question "What are ZClasses? (see 
<http://zdp.zope.org/projects/zfaq/faq/ZClasses>).

- When answering this question I selected the "stx" format. I do think I 
created separate paragraphs in the answer. However, all the text is 
appended on the <http://zdp.zope.org/projects/zfaq/faq/ZClasses> page. Is 
the stx format implemented?

- In the Add Answer form, I suggest providing a selection list to pick the 
format (stx, html, etc.) to avoid typos.

- In the <http://zdp.zope.org/projects/zfaq/faq/ZClasses> page for 
instance, a question / answer contributor name displays as "Contributed by 
visitor AlexR (alex@gabuzomeu.net)". Instead of showing the email address 
as text, I suggest creating a link from the contributor name to save screen 
space.

Maïk, if my rantings make any sense, I can give you a hand to implement them.


Cheers.

Alexandre