Re: [Zope-dev] zope2docs

2009-02-23 Thread Simon Michael
Tres Seaver wrote:
 thanks a lot for the effort that has been put into the new zope 
 documentation.

 the colors of the index (light green on whit) is uncomfortable to my eyes and

+1 and +1. It may be an interim solution, but it's currently the best 
Zope docs site, and it should be 1-minute job to change the foreground 
color to black, say. Thanks!

___
Zope-Dev maillist  -  Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://mail.zope.org/mailman/listinfo/zope-announce
 http://mail.zope.org/mailman/listinfo/zope )


Re: [Zope-dev] zope2docs

2009-02-23 Thread Andreas Jung
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 23.02.2009 17:12 Uhr, Simon Michael wrote:
 Reinout van Rees wrote:
 And: I don't mind doing a bit of this work. But: I'm getting a bit
 lost in the various websites (old/new/unfinished/never_started).

 Absolutely, we need a map.

 http://www.zope.org/DevHome/
   The stuff to be moved to svn.

 Andreas, fwiw I don't think that is a wiki, but
 http://zope.org/DevHome/Subversion is. I have a list of
 http://wiki.zope.org/WikisStillOnZopeOrg . Perhaps more of these, at
 least the non-member ones, should move either to sphinx/svn or to
 wiki.zope.org. Consolidation is good.

I moved most of the relevant stuff into SVN this afternoon:

http://svn.zope.org/developer_docs/trunk/source/

I've rewritten parts of the documentation, other stuff must be rechecked
- - especially the stuff about becoming a contributor. I am definitely in
favor for moving/maintaining such such in SVN. Sphinx allows us to
structure the documentation the very well (especially hierarchically)
and it provides a powerful pipeline for generating nice looking output
(HTML/PDF).

Andreas
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.9 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAkmizlsACgkQCJIWIbr9KYyqqwCePiNs1q4mW9YpwtporagQ2Wqc
5v0AoMcFVtez2WxAD8IWN0UZiFn2m/h3
=27Zq
-END PGP SIGNATURE-
begin:vcard
fn:Andreas Jung
n:Jung;Andreas
org:ZOPYX Ltd.  Co. KG
adr;quoted-printable:;;Charlottenstr. 37/1;T=C3=BCbingen;;72070;Germany
email;internet:i...@zopyx.com
title:CEO
tel;work:+49-7071-793376
tel;fax:+49-7071-7936840
tel;home:+49-7071-793257
x-mozilla-html:FALSE
url:www.zopyx.com
version:2.1
end:vcard

___
Zope-Dev maillist  -  Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://mail.zope.org/mailman/listinfo/zope-announce
 http://mail.zope.org/mailman/listinfo/zope )


Re: [Zope-dev] zope2docs

2009-02-23 Thread Simon Michael
Andreas Jung wrote:
 I moved most of the relevant stuff into SVN this afternoon:

Ok, were you able to clean up, ie delete, the obsolete content as well ?
  I think this is an important step we need more of in Zope docs-land.

___
Zope-Dev maillist  -  Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://mail.zope.org/mailman/listinfo/zope-announce
 http://mail.zope.org/mailman/listinfo/zope )


Re: [Zope-dev] zope2docs

2009-02-23 Thread Andreas Jung
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 23.02.2009 17:45 Uhr, Simon Michael wrote:
 Andreas Jung wrote:
 I moved most of the relevant stuff into SVN this afternoon:
 
 Ok, were you able to clean up, ie delete, the obsolete content as well ?
   I think this is an important step we need more of in Zope docs-land.

I think there is need for a volunteer or a dictator for docs.zope.org
before we can get rid of the old stuff. Most of the tasks for
docs.zope.org are low-hanging fruits:

 - the new.zope.org skins should be removed for docs.zope,org. Since
   all/most of the content will be auto-generated through Sphinx it
   should be sufficient to adjust the color scheme, putting a Zope logo
   on the page

 - bringing the documentation in the right structure. Right now we have
   in SVN:
   - zope2docs
   - zope3docs
   - developer_docs

  This could be the base for the final structure. Additional how-level
  hierachies could be:

   - tools (e.g. for Buildout)
   - packages (e.g. for the z3c. packages)

 - set up some mechanism for updating docs.zope.org regulary
   or manually (I think Jens is doing this manually right now)

 - after that: kick dev.zope.org, adjust the related links
   on the current zope.org front-page to their new location

Andreas


- -- 
ZOPYX Ltd.  Co. KG - Charlottenstr. 37/1 - 72070 Tübingen - Germany
Web: www.zopyx.com - Email: i...@zopyx.com - Phone +49 - 7071 - 793376
Registergericht: Amtsgericht Stuttgart, Handelsregister A 381535
Geschäftsführer/Gesellschafter: ZOPYX Limited, Birmingham, UK
- 
E-Publishing, Python, Zope  Plone development, Consulting

-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.9 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAkmi1ccACgkQCJIWIbr9KYxB9ACgklJVeaIdN+9zNOczLb+IHoPO
MfkAmwduXIZwRYfhP8rEETJYU3+6SQWe
=4qrN
-END PGP SIGNATURE-
begin:vcard
fn:Andreas Jung
n:Jung;Andreas
org:ZOPYX Ltd.  Co. KG
adr;quoted-printable:;;Charlottenstr. 37/1;T=C3=BCbingen;;72070;Germany
email;internet:i...@zopyx.com
title:CEO
tel;work:+49-7071-793376
tel;fax:+49-7071-7936840
tel;home:+49-7071-793257
x-mozilla-html:FALSE
url:www.zopyx.com
version:2.1
end:vcard

___
Zope-Dev maillist  -  Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://mail.zope.org/mailman/listinfo/zope-announce
 http://mail.zope.org/mailman/listinfo/zope )


Re: [Zope-dev] zope2docs

2009-02-23 Thread Jens Vagelpohl
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1


On Feb 23, 2009, at 17:58 , Andreas Jung wrote:

 - the new.zope.org skins should be removed for docs.zope,org. Since
   all/most of the content will be auto-generated through Sphinx it
   should be sufficient to adjust the color scheme, putting a Zope logo
   on the page

The front page for docs.zope.org is a filesystem page with hardcoded  
design since it is not generated. Once a design has been agreed on I  
can adjust it.


 - set up some mechanism for updating docs.zope.org regulary
   or manually (I think Jens is doing this manually right now)

Most content is auto-updated once a day automatically with a cron job.

My opinion: The more content that can be auto-generated and stuffed  
onto the file system, the better.

jens

-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.8 (Darwin)

iEYEARECAAYFAkmi4tkACgkQRAx5nvEhZLKRvgCgmDrKqf+ECunu+mWuw7g2w9ZC
t2kAoIZIUszqpSDIYmdNoO6feyElKv0t
=+qUb
-END PGP SIGNATURE-
___
Zope-Dev maillist  -  Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://mail.zope.org/mailman/listinfo/zope-announce
 http://mail.zope.org/mailman/listinfo/zope )


Re: [Zope-dev] zope2docs

2009-02-22 Thread Andreas Jung
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 21.02.2009 15:26 Uhr, robert rottermann wrote:
 thanks a lot for the effort that has been put into the new zope documentation.
 I have a litte wish:
 the colors of the index (light green on whit) is uncomfortable to my eyes and
 hard to read.
 maybe this could be changed to a more contrasting combination?
 robert

docs.zope.org is definitely only a  interim solution (see broken
links in the tabs). I think it should be a long-hanging fruit bringing
docs.zope.org into a reasonable state since we csn auto-generate a bunch
of documentation directly through Sphinx.

Andreas
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.9 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAkmhl7gACgkQCJIWIbr9KYwlDgCgkEpsmlmrIxz3jn6Ar6k8uGU/
1d0AnAhZRAmwD3/+1kDcJWnCvb31rwGs
=bnqU
-END PGP SIGNATURE-
begin:vcard
fn:Andreas Jung
n:Jung;Andreas
org:ZOPYX Ltd.  Co. KG
adr;quoted-printable:;;Charlottenstr. 37/1;T=C3=BCbingen;;72070;Germany
email;internet:i...@zopyx.com
title:CEO
tel;work:+49-7071-793376
tel;fax:+49-7071-7936840
tel;home:+49-7071-793257
x-mozilla-html:FALSE
url:www.zopyx.com
version:2.1
end:vcard

___
Zope-Dev maillist  -  Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://mail.zope.org/mailman/listinfo/zope-announce
 http://mail.zope.org/mailman/listinfo/zope )


Re: [Zope-dev] zope2docs

2009-02-21 Thread robert rottermann
thanks a lot for the effort that has been put into the new zope documentation.
I have a litte wish:
the colors of the index (light green on whit) is uncomfortable to my eyes and
hard to read.
maybe this could be changed to a more contrasting combination?
robert
Andreas Jung schrieb:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1
 
 In preparation for the upcoming Zope 2.12 release we reorganized the
 Zope 2 documentation:
 
 - - all related documentation is now maintained a restructured text
   document in SVN:
 
   svn+ssh://svn.zope.org/repos/main/zope2docs
 
 - - The Zope Book, The Zope Developers Guide and some ZODB
   articles have been converted from STX to ReST
 
 - - The Zope 2.12 doc folder has been restified and is included
   within the zope2docs folder through a svn:external
 
 - - The Zope 2 specific documentation including releases notes will
   be generated in the future using Sphinx from 'zope2docs2' and
   published on docs.zope.org
 
 Thanks to Hanno and Tres for reSTifying the Zope book and the ZDG.
 
 Andreas
 
 
 
 - -- 
 ZOPYX Ltd.  Co. KG - Charlottenstr. 37/1 - 72070 Tübingen - Germany
 Web: www.zopyx.com - Email: i...@zopyx.com - Phone +49 - 7071 - 793376
 Registergericht: Amtsgericht Stuttgart, Handelsregister A 381535
 Geschäftsführer/Gesellschafter: ZOPYX Limited, Birmingham, UK
 - 
 E-Publishing, Python, Zope  Plone development, Consulting
 
 -BEGIN PGP SIGNATURE-
 Version: GnuPG v1.4.9 (Darwin)
 Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
 
 iEYEARECAAYFAkmgDVAACgkQCJIWIbr9KYyZMQCfShleZE5uqRL2f/UJvXxwkz8X
 QKoAmQHSNGC/mJMxxznzK79aAPidRc9k
 =Nw53
 -END PGP SIGNATURE-
 
 ___
 Zope-Dev maillist  -  Zope-Dev@zope.org
 http://mail.zope.org/mailman/listinfo/zope-dev
 **  No cross posts or HTML encoding!  **
 (Related lists - 
  http://mail.zope.org/mailman/listinfo/zope-announce
  http://mail.zope.org/mailman/listinfo/zope )

___
Zope-Dev maillist  -  Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://mail.zope.org/mailman/listinfo/zope-announce
 http://mail.zope.org/mailman/listinfo/zope )


Re: [Zope-dev] zope2docs

2009-02-21 Thread Tres Seaver
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

robert rottermann wrote:
 thanks a lot for the effort that has been put into the new zope documentation.
 I have a litte wish:
 the colors of the index (light green on whit) is uncomfortable to my eyes and
 hard to read.
 maybe this could be changed to a more contrasting combination?

+10 from me.  Readability should trump design every time.

 Andreas Jung schrieb:
 In preparation for the upcoming Zope 2.12 release we reorganized the
 Zope 2 documentation:
 
 - all related documentation is now maintained a restructured text
   document in SVN:
 
   svn+ssh://svn.zope.org/repos/main/zope2docs
 
 - The Zope Book, The Zope Developers Guide and some ZODB
   articles have been converted from STX to ReST
 
 - The Zope 2.12 doc folder has been restified and is included
   within the zope2docs folder through a svn:external
 
 - The Zope 2 specific documentation including releases notes will
   be generated in the future using Sphinx from 'zope2docs2' and
   published on docs.zope.org
 
 Thanks to Hanno and Tres for reSTifying the Zope book and the ZDG.

Baiju did the main work on the ZDG:  I just slurped the TTW content into
SVN.


- --
===
Tres Seaver  +1 540-429-0999  tsea...@palladion.com
Palladion Software   Excellence by Designhttp://palladion.com
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFJoDkM+gerLs4ltQ4RAnJpAJ0QU3r6CwP08WtWX4iMqw5XhZA2SwCgkb9W
S57lPagcGIZslydxGGZcvx0=
=GooC
-END PGP SIGNATURE-
___
Zope-Dev maillist  -  Zope-Dev@zope.org
http://mail.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://mail.zope.org/mailman/listinfo/zope-announce
 http://mail.zope.org/mailman/listinfo/zope )