History for Requirements
??changed:- This is some content snipped from Jon's email and my comments, this is not refined - Synthesize material from the zope lists, guides, howtos, as well as from interviews with key zopistas, into a series of topically-focused articles. MichelP -- So [Articles] will be a key artifact, as well as [Interviews] (which may just be a kind of Article). - Tag each article with metadata vocabularies (e.g. GeneralTopic: ZODB, Activity: backup_and_recovery). Aim to develop these vocabularies as general ones that the community would want to use to categorize other non-Gazette material. MichelP -- We have a general pattern we call [Topics], which we have realized in ZTopics (but never released) and I also believe is being used in the [PTK]. - Within articles, develop named components (e.g., DtmlCodeFragment, DiscussionPoint, BestPracticesList) which can be reused in other contexts. MichelP I snipped some stuff here and put them under [Requirements]. - Use RSS to broadcast the Gazette, possibly not just at the issue level (Issue #1) but at the more granular component level (e.g.: DiscussionPoint, ZopeTip). - Use a simple XHTML-oriented technique for writing, which could also enhance the quality and reusability of howtos without raising the bar too high for would-be contributors. (In other words, people write HTML howtos easily today. Few are likely to write DocBook XML howtos. XHTML howtos could be a useful middle ground.) - Instrument each article with discussion apparatus. ZDiscussions is preferable to ZWiki, and rather than one forum per article, it's best to have one forum per high-level topic (e.g. a ZODB forum, linked to from multiple articles about ZODB). - Aim for these ZDiscussions to become destinations which, over time, can supersede non-Zope-based mailing-lists as the locus of community discussion. (Is there anyone in the Zope community who thinks Zope is *not* the right tool for managing its own community's interactions? Would moving in that direction rub people the wrong way? My own suspicion is that mailing lists are just a bad habit, but then, I do understand that you muck with people's habits at your peril. ) - Post a draft of each article to a group of reviewers, incorporate feedback into the first release of the article, linked to from zope.org.