Re: Some structural improvements

Toby Dickenson wrote:
> On Monday 12 Sep 2005 16:07, Philipp von Weitershausen wrote:
> 
>>When I wanted to document my changes, I realized that the documentation
>>was kept in a .zexp file and the text docs as well as the website were
>>generated from that. With Toby's consent I converted all docs (including
>>those that were only available on the website) to reStructuredText, a
>>plain text format commonly accepted in the Python community. I also
>>added a tool that lets Toby generate the website from the reST docs.
>>These changes went to the philikon-restify-docs-branch which I hereby
>>also submit for review and merging to HEAD. Please let me know if you
>>have suggestions or improvements.
> 
> Also now merged.

Thanks! I was about to ask you about this branch.

> converting all those html pages to restructured text must 
> have been some major work.... do you have a tool for that?

No, not really. I took the plain text version of the files created with
lynx and then used emacs to edit them. Emacs solves most of the pain
when editing indented text, e.g. bullet point lists. I figured before I
manage to write a tool that produces *nice* reStructuredText, I had done
all the work myself. It turned it out it wasn't all that much.

> I had to fix a case sensitivity (INSTALL.txt, install.html) bug which you may 
> want to review. 

Ah, yes. Thank you. Damn that case-insensitive HFS+.

I will be making some final changes to the docs mentioning the situation
in a Zope 3 setup this week. I then consider my work done as far as
rudimentary Zope 3 support is concerned. How would you feel about a
1.1.16 release soon?

Philipp


-------------------------------------------------------
This SF.Net email is sponsored by:
Power Architecture Resource Center: Free content, downloads, discussions,
and more. http://solutions.newsforge.com/ibmarch.tmpl