combining all zope2 FAQs into one big one at wiki.zope., org/zope2
hi all it seems that there are scattered faqs or zope 2 abound (http://wiki.zope.org/zope2/FAQs), and combining them all in one site (wiki.zope.org/zope2) seems the best solution, imho. so, i'm trying to ask all site owners with zope2 faqs whether we can achieve this? help from the community is also welcome. a good place to start is to replace the current http://wiki.zope.org/zope2/FAQs with faqs collected from various sites and use a template such as zope3.wiki.org/FAQ However, since it's taken Ive created http://wiki.zope.org/zope2/Zope2FAQs to get the ball rolling. The stuff there are just place holders. But with the permission of site owners i'd like to start transfer stuff over. thoughts? comments? -- http://myzope.kedai.com.my - my-zope org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 7 Nov 2006, at 07:17, Bakhtiar A Hamid wrote:
The stuff there are just place holders. But with the permission of site owners i'd like to start transfer stuff over.
thoughts? comments?
I can comment on two of those links (well, one is gone now ;) - - the CMF FAQ does not exist. I removed the link. - - the German FAQ (I corrected the link) is not a suitable candidate for absorption into wiki.zope.org. One goal for the site at www.zope.de is to have a single point for German language Zope docs, and it should stay that way. jens -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (Darwin) iD8DBQFFUDquRAx5nvEhZLIRAk9eAKC7onSzcI4lZYI0FHMYohtSXn9bagCgjgR8 rzcCnbe/R3D7RL5wMJ0kavY= =1TvT -----END PGP SIGNATURE-----
On 11/7/06, Jens Vagelpohl <jens@dataflake.org> wrote:
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
On 7 Nov 2006, at 07:17, Bakhtiar A Hamid wrote:
The stuff there are just place holders. But with the permission of site owners i'd like to start transfer stuff over.
thoughts? comments?
I can comment on two of those links (well, one is gone now ;)
- - the CMF FAQ does not exist. I removed the link.
- - the German FAQ (I corrected the link) is not a suitable candidate for absorption into wiki.zope.org. One goal for the site at www.zope.de is to have a single point for German language Zope docs, and it should stay that way.
understood. was thinking more about the english faqs.
jens
-----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (Darwin)
iD8DBQFFUDquRAx5nvEhZLIRAk9eAKC7onSzcI4lZYI0FHMYohtSXn9bagCgjgR8 rzcCnbe/R3D7RL5wMJ0kavY= =1TvT -----END PGP SIGNATURE----- _______________________________________________ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
-- http://myzope.kedai.com.my - my-zope org
+1 for most of them, thanks for doing this. How about just /FAQ, then wiki.zope.org/zope2/faq works, it's consistent with zope3 etc. FAQs can become a placeholder pointing there.
PS, here's a word of warning to FAQ writers from my own experience, a trap to avoid: You start writing answers for questions - it's so easy and tempting - later you find better answers out on the web, even elsewhere in the same wiki, but now you have a big, verbose body of duplicated docs that's too good to throw away but not quite valuable enough to attract a lot of maintenance. Result: stagnation. How to avoid this ? Maybe keeping these goals in mind will help: - research, link, gather, consolidate docs first; write new ones as last resort - keep answers in the faq short and to the point, link to best detailed docs elsewhere - avoid unnecessary duplication. Use the contents link to see what's in the zope2 and other zope wikis. Refactor the wiki content aggressively when appropriate. Also, long wiki pages are less fun to edit than short ones, use an external editor for FAQ work to avoid this pain. Emacs users, try rst-mode.el. -Simon
participants (3)
-
Bakhtiar A Hamid -
Jens Vagelpohl -
Simon Michael