## page was renamed from swordsp/WP:COTW ||'''啄木鸟维基条目质量提升计划 '''|| {{attachment:contribute_docs.jpg}} || B-) [[swordsp]] [<>] || <> === 发起 === * '''[[PyCNmail:2006-July/027455.html|-倡议-啄木鸟条目质量提升计划]]''' -- swordsp的最初倡议 {{{ 一、缘起 不知道大家有没有感觉到，最近邮件列表中某些常见问题又开始大量重复出现了。 诸如大家用什么IDE、python可以干什么、初学者应该怎样入门……，尽管每次都有许多热心人解答，但这一方面是一种重复劳动的浪费，另一方面每次只言片语的回答往往也不够系统。 有感于此，我觉得作为社区最重要的资源，啄木鸟wiki长期以来一直没有得到很好的利用。 本来这些信息应该在wiki上有专门的目录和介绍性页面，以此为入口链接到更深层的知识条目，这样提问者被指引到这样的页面后就一目了然了。 而且这相当于授人以渔，进一步的发掘和学习同类知识也有了很好的方向。 二、现状 然而，啄木鸟wiki虽然一直在不断的建设和完善，但是将各条目内容系统化组织起来的工作似乎做得并不好。 大量有价值的信息散落在各处，缺乏明确一致的入口，这样作为wiki的价值就大打折扣了。 比如，我想在啄木鸟上找出关于python IDE的概述，就发现了如下几个相关条目： http://wiki.woodpecker.org.cn/moin/PyGuiDev 这个条目本来应该是讲GUI的，但事实上前半部分是介绍的IDE，不过只有几个条目的链接，信息很少。 http://wiki.woodpecker.org.cn/moin/PyIDEguider 这个条目比较像，但绝大部分内容是关于Vim的，其它的介绍很少。 http://wiki.woodpecker.org.cn/moin/PythonCN/FAQ#head-43372031dda15e6a1915f1990fe663e8b1ba71c9 这个FAQ的条目中有一点，但语焉不详，也有些不确切之处（比如，activepython和pythonwin其实是一个东西，eclipse+pydev也是跨平台的，等等）。 总之，无法指引出一个全面而完整的介绍性条目，类似这样的情况还有许多，不少主题性的内容，都需要翻查数个页面，再结合搜索功能才能找出完整的相关信息。 此外，许多重要的主题性条目的内容也不够多不够新，比如数据库、网络、文本处理相关的条目。 三、设想 有鉴于此，我想效仿Wikipedia，发起啄木鸟自己的"条目质量提升计划"[1]。 [1] Wikipedia:条目质量提升计划 本来wiki的目的就是大家一起贡献内容不断完善，不发起什么计划也是一样的。不过wikipedia的经验以及啄木鸟之前组织的集体翻译都证明了，这样群策群力的事情当有了组织和制度之后，大伙儿的劲头才会更足，才能更有效率和质量的完成。 计划的主要内容是，在首页和原先的FLOSS首页之外，建立起一系列的"一级主题条目"，可能包括以下这些内容： 语言类：语法、算法和数据结构、扩展和嵌入、中文处理…… 应用类：数据库、网络、文本处理、并发编程…… 资源类：IDE、书籍、网站…… …… 这样的条目最终能够建设成： 1. 作为介绍，对这个主题的相关知识有一个完整而简单的提纲式概括，但不深入细节。 2. 作为入口目录，尽量链接到啄木鸟内部的所有相关条目，使得相关知识能以此为中心紧密组织在一起。 可能的话，以现有类似条目为基础，原先的内容不全不新的话只需作提纲式补充即可。 反之，对于某个子项目展开过多的章节都可以剥离成单独的条目，以保证主题页的简洁。 以此为基础，一方面可以把啄木鸟的首页重新整理为更清晰的最上级目录，另一方面可以重写专门的FAQ页面，将许多问题直接指引到专门的主题条目去。 这样的主题条目本身数量有限（十几条？），而且内容不需要太细致，应该可以在不长的时间内整理完成。 接下来如果大家有兴趣的话，可以进一步仿照wikipedia，以两周到一个月为单位，对某些更细节的条目集中火力作质量提升，以促进啄木鸟的长期良性发展。 四、实行 我先按照我的设想大致写了一个PyIDE条目的提纲，欢迎大家一起帮忙完成，或者以此为例子讨论我的计划。 http://wiki.woodpecker.org.cn/moin/PyIDE }}} === 计划 === 当前主要任务为一级主题条目的完善。 '''一级主题条目'''一般涵盖一个较大的相关领域，在知识树中处于仅次于首页的最上级节点，也是相关领域知识整理的中心节点。 这类主题条目数量不多，但其品质对于整个啄木鸟的结构组织、使用友好度有相当大的影响，因此将其选定为优先级最高的任务，希望能吸引更多人集中注意力尽快将其完善。 计划的目标是将主题条目整理为 * 一份简明的概要式说明文档，尽可能全面和更新，但尽量不牵涉到细节 * 一份完整的资源目录，尽可能将散落于网际（啄木鸟内部和外部）的相关知识组织索引，为读者提供更深入和细致的指引 原则上，计划定位在知识的“整理”而非“创造”，力求将现存的知识（尤其是啄木鸟以及中文Python社区内部）效用最大化，降低后来者的学习成本，避免重复劳动。 计划的灵感和形式很大程度上来自于[[http://zh.wikipedia.org|Wikipedia]]的[[http://zh.wikipedia.org/wiki/WP:COTW|条目质量提升计划]]。 目前计划中的一级主题条目包括： （ (./) 为初步完成， {*} 为进行中） * 语言和基础领域类 * [[PythonLanguage|Python 语言研究]] {*} * [[PythoNology|蟒学]] * 算法和数据结构 * 并发编程 * 应用领域类 * Web开发 * [[Py4Database|Python数据库开发概要]] {*} * [[PyGuiDev|GUI开发]] * 网络编程 * 科学计算 * 文本处理 * XML * 正则表达式 * 多媒体处理 * 游戏开发 * 资源类 * [[PyIDE|IDE介绍]] (./) * 初学者指引 * [[PyBooks|Python图书概览]] (./) * 基于Python的软件——安装、配置和使用（Trac、MoinMoin、Buildbot...） * Python网络资源汇集 * …… 有一部分主题将以现有类似条目为基础，还有一部分主题需整理自现存的若干条目或从头开始写作。 === 进展 === 进行中（以及完成不久）的条目将会在页面前加入如下提示： <> ==== 初步完成条目 ==== ===== PyIDE ===== [[PyIDE]] -- 介绍Python程序员常用的IDE和其它开发工具 * 主要贡献者 * [[swordsp]] * XiaoDeShi * [[Chris]] * …… * 参考资料 * PyGuiDev * [[PyIDEguider]] * [[PythonCN/FAQ#head-43372031dda15e6a1915f1990fe663e8b1ba71c9|PythonCN/FAQ]] * 条目正文中列举的其它链接 * TODO * ipython 和 winpdb 的介绍 * 主流 IDE 比较的 feature matrix * Py{{{}}}Dev 的更多使用经验 ===== PyBooks ===== PyBooks -- Python 图书概览 * 更新纪要 * 初步完成 -- [[swordsp]] <> * 大幅更新，更新部分06年出版的新书信息，增加国内正式出版的python图书信息（翻译或影印），增加社区图书计划的宣传条 -- [[swordsp]] [2007-01-11] * 参考资料 * http://wiki.python.org/moin/PythonBooks * http://www.awaretek.com/book.html * 条目正文中列举的其他链接 * TODO * 收集整理更多读书笔记 ==== 进行中条目 ==== ===== Py4Database ===== Py4Database -- Python 数据库开发概要 * 更新纪要 * 基本完成提纲 -- [[swordsp]] [<>] * [[ibear|大熊]]添加PyTables和Mk4py章节，[[neo]]添加SQL Server章节 [<>] * HuangYi 添加 [[SQLAlchemy]] 专题条目 [<>] * 页面结构大幅调整，独立 [[DatabaseModules|Python 数据库接口模块]] 条目，充实非关系数据库部分内容 -- -- [[swordsp]] [<>] * 参考资料 * http://www.python.org/doc/topics/database/ * AllAboutData * 条目正文中列举的其它链接 ===== PythonLanguage ===== PythonLanguage -- Python 语言研究 * 更新纪要 * 初稿完成，主要整理了啄木鸟上现有资料、 limodou 和 HuangYi 的个人 blog 以及 IBM developerWorks 的相关文章（及部分延伸链接）-- [[swordsp]] <> * 参考资料 * http://www.python.org/doc/newstyle/ * [[ThinkIntoPython]] * [[PythonZhDoc]] * [[PythoNology]] * http://www.voidspace.org.uk/python/index.shtml * [[http://www.ibm.com/developerworks/cn/linux/theme/special/index.html#python|IBM developerWorks 的 Python 专栏]] * [[http://blog.donews.com/limodou/|limodou 的学习记录]] -- limodou 的 blog * [[http://codeplayer.blogspot.com|白菜]] -- HuangYi 的 blog * TODO * 收集邮件列表中的相关讨论主题 * 收集更多 blog 中的有价值文章 ==== 其它草稿和影响条目 ==== * 处于 alpha 版状态的内部工作页面 * 修改中的[[swordsp/COTW/WoodpeckerIdxDoc|新版Python文档中心页面]] * [[swordsp/PyResources|Python 资源中心]] * [[swordsp/PyXML|Python 与 XML 资料搜集]] === 参与 === 由于wiki本身的自由，所以无需特殊的手续，只要对任何感兴趣的计划中条目贡献内容，使其更完整、准确即可。 如果该主题尚未开启合适条目，亦可自行建立。 鼓励贡献者将自己的更新纪录于本页面的“进展”一节中，但不是必要的。 === 反馈 === <>