Diff for "swordsp/COTW" - Woodpecker Wiki for CPUG

Differences between revisions 35 and 36

啄木鸟维基条目质量提升计划

swordsp [2007-01-16 15:58:11]

Contents

发起
计划
进展
参与
反馈

发起

-倡议-啄木鸟条目质量提升计划 -- 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社区内部）效用最大化，降低后来者的学习成本，避免重复劳动。

计划的灵感和形式很大程度上来自于Wikipedia的条目质量提升计划。

目前计划中的一级主题条目包括：（为初步完成，为进行中）

语言和基础领域类
- Python 语言研究
- 蟒学
- 算法和数据结构
- 并发编程
应用领域类
- Web开发
- Python数据库开发概要
- GUI开发
- 网络编程
- 科学计算
- 文本处理
  - XML
  - 正则表达式
- 多媒体处理
- 游戏开发
资源类
- IDE介绍
- 初学者指引
- Python图书概览
- 基于Python的软件——安装、配置和使用（Trac、MoinMoin、Buildbot...）
- Python网络资源汇集
……

有一部分主题将以现有类似条目为基础，还有一部分主题需整理自现存的若干条目或从头开始写作。

进展

进行中（以及完成不久）的条目将会在页面前加入如下提示：

此条目正在进行条目质量提升计划，详情请阅读项目首页。

欢迎对此页面进行补充和修正，也请关注计划中的其它页面，为啄木鸟贡献您的一份力量。

近期活跃条目： Python 图书概览 Python数据库开发概要 Python 语言研究

初步完成条目

PyIDE

PyIDE -- 介绍Python程序员常用的IDE和其它开发工具

主要贡献者
- swordsp
- XiaoDeShi
- Chris
- ……
参考资料
- PyGuiDev
- PyIDEguider
- PythonCN/FAQ
- 条目正文中列举的其它链接
TODO
- ipython 和 winpdb 的介绍
- 主流 IDE 比较的 feature matrix
- PyDev 的更多使用经验

PyBooks

PyBooks -- Python 图书概览

更新纪要
- 初步完成 -- swordsp 2006-07-22
- 大幅更新，更新部分06年出版的新书信息，增加国内正式出版的python图书信息（翻译或影印），增加社区图书计划的宣传条 -- swordsp [2007-01-11]
参考资料
- http://wiki.python.org/moin/PythonBooks
- http://www.awaretek.com/book.html
- 条目正文中列举的其他链接
TODO
- 收集整理更多读书笔记

进行中条目

Py4Database

Py4Database -- Python 数据库开发概要

更新纪要
- 基本完成提纲 -- swordsp [2006-07-16 17:53:04]
- 大熊添加PyTables和Mk4py章节，neo添加SQL Server章节 [2006-07-18]
- HuangYi 添加 SQLAlchemy 专题条目 [2007-01-16 15:58:11]
- 页面结构大幅调整，独立 Python 数据库接口模块条目，充实非关系数据库部分内容 -- -- swordsp [2007-01-16 15:58:11]
参考资料
- http://www.python.org/doc/topics/database/
- AllAboutData
- 条目正文中列举的其它链接

PythonLanguage

PythonLanguage -- Python 语言研究

更新纪要
- 初稿完成，主要整理了啄木鸟上现有资料、 limodou 和 HuangYi 的个人 blog 以及 IBM developerWorks 的相关文章（及部分延伸链接）-- swordsp 2007-01-15 06:46:01
参考资料
- http://www.python.org/doc/newstyle/
- ThinkIntoPython
- PythonZhDoc
- PythoNology
- http://www.voidspace.org.uk/python/index.shtml
- IBM developerWorks 的 Python 专栏
- limodou 的学习记录 -- limodou 的 blog
- 白菜 -- HuangYi 的 blog
TODO
- 收集邮件列表中的相关讨论主题
- 收集更多 blog 中的有价值文章

其它草稿和影响条目

处于 alpha 版状态的内部工作页面
- 修改中的新版Python文档中心页面
- Python 资源中心
- Python 与 XML 资料搜集

参与

由于wiki本身的自由，所以无需特殊的手续，只要对任何感兴趣的计划中条目贡献内容，使其更完整、准确即可。

如果该主题尚未开启合适条目，亦可自行建立。

鼓励贡献者将自己的更新纪录于本页面的“进展”一节中，但不是必要的。

反馈

欢迎大家的意见和反馈！

怎么最近不见动静了呢？ -- ZhangYunfeng 2006-08-03 13:49:05

去年下半年太忙了，一偷懒就放下了-_-b 新年新气象，现在又该重新开张了~ -- swordsp 2007-01-15 06:41:52

-  ⇤ ← Revision 35 as of 2007-10-26 00:19:52 → 
  Size: 9927
  Editor: ZoomQuiet
  Comment:
+   ← Revision 36 as of 2009-12-25 07:14:43 → ⇥
  Size: 9950
  Editor: localhost
  Comment: converted to 1.6 markup
-Deletions are marked like this.
+Additions are marked like this.
 Line 3:
-||'''啄木鸟维基条目质量提升计划 '''|| attachment:contribute_docs.jpg || B-) ["swordsp"] [[[DateTime(2007-01-16T15:58:11Z)]]]  ||
+||'''啄木鸟维基条目质量提升计划 '''|| {{attachment:contribute_docs.jpg}} || B-) [[swordsp]] [<<DateTime(2007-01-16T15:58:11Z)>>]  ||
 Line 5:
-[[TableOfContents]]
+<<TableOfContents>>
 Line 8:
- * '''[wiki:PyCNmail:2006-July/027455.html -倡议-啄木鸟条目质量提升计划]''' -- swordsp的最初倡议
+ * '''[[PyCNmail:2006-July/027455.html|-倡议-啄木鸟条目质量提升计划]]''' -- swordsp的最初倡议
 Line 63:
-计划的灵感和形式很大程度上来自于[http://zh.wikipedia.org Wikipedia]的[http://zh.wikipedia.org/wiki/WP:COTW 条目质量提升计划]。
+计划的灵感和形式很大程度上来自于[[http://zh.wikipedia.org|Wikipedia]]的[[http://zh.wikipedia.org/wiki/WP:COTW|条目质量提升计划]]。
 Line 68:
-  * [:PythonLanguage:Python 语言研究] {*}
  * [:PythoNology:蟒学]
+  * [[PythonLanguage|Python 语言研究]] {*}
  * [[PythoNology|蟒学]]
 Line 74:
-  * [:Py4Database:Python数据库开发概要] {*}
  * [:PyGuiDev:GUI开发]
+  * [[Py4Database|Python数据库开发概要]] {*}
  * [[PyGuiDev|GUI开发]]
 Line 84:
-  * [:PyIDE:IDE介绍] (./)
+  * [[PyIDE|IDE介绍]] (./)
 Line 86:
-  * [:PyBooks:Python图书概览] (./)
+  * [[PyBooks|Python图书概览]] (./)
 Line 95:
-[[Include(/Header)]]
+<<Include(/Header)>>
 Line 99:
-["PyIDE"] -- 介绍Python程序员常用的IDE和其它开发工具
+[[PyIDE]] -- 介绍Python程序员常用的IDE和其它开发工具
 Line 102:
-  * ["swordsp"]
+  * [[swordsp]]
 Line 104:
-  * ["Chris"]
+  * [[Chris]]
 Line 108:
-  * ["PyIDEguider"]
  * [:PythonCN/FAQ#head-43372031dda15e6a1915f1990fe663e8b1ba71c9:PythonCN/FAQ]
+  * [[PyIDEguider]]
  * [[PythonCN/FAQ#head-43372031dda15e6a1915f1990fe663e8b1ba71c9|PythonCN/FAQ]]
 Line 119:
-  * 初步完成 -- ["swordsp"] [[Date(2006-07-22T15:42:13Z)]]
+  * 初步完成 -- [[swordsp]] <<Date(2006-07-22T15:42:13Z)>>
 Line 121:
-  * 大幅更新，更新部分06年出版的新书信息，增加国内正式出版的python图书信息（翻译或影印），增加社区图书计划的宣传条 -- ["swordsp"] [2007-01-11]
+  * 大幅更新，更新部分06年出版的新书信息，增加国内正式出版的python图书信息（翻译或影印），增加社区图书计划的宣传条 -- [[swordsp]] [2007-01-11]
 Line 134:
-  * 基本完成提纲 -- ["swordsp"] [[[DateTime(2006-07-16T17:53:04Z)]]]
  * [:ibear:大熊]添加PyTables和Mk4py章节，["neo"]添加SQL Server章节 [[[Date(2006-07-18T04:22:34Z)]]]
  * HuangYi 添加 ["SQLAlchemy"] 专题条目 [[[DateTime(2007-01-16T15:58:11Z)]]]
  * 页面结构大幅调整，独立 [:DatabaseModules:Python 数据库接口模块] 条目，充实非关系数据库部分内容 -- -- ["swordsp"] [[[DateTime(2007-01-16T15:58:11Z)]]]
+  * 基本完成提纲 -- [[swordsp]] [<<DateTime(2006-07-16T17:53:04Z)>>]
  * [[ibear|大熊]]添加PyTables和Mk4py章节，[[neo]]添加SQL Server章节 [<<Date(2006-07-18T04:22:34Z)>>]
  * HuangYi 添加 [[SQLAlchemy]] 专题条目 [<<DateTime(2007-01-16T15:58:11Z)>>]
  * 页面结构大幅调整，独立 [[DatabaseModules|Python 数据库接口模块]] 条目，充实非关系数据库部分内容 -- -- [[swordsp]] [<<DateTime(2007-01-16T15:58:11Z)>>]
 Line 147:
-  * 初稿完成，主要整理了啄木鸟上现有资料、 limodou 和 HuangYi 的个人 blog 以及 IBM developerWorks 的相关文章（及部分延伸链接）-- ["swordsp"] [[DateTime(2007-01-15T06:46:01Z)]]
+  * 初稿完成，主要整理了啄木鸟上现有资料、 limodou 和 HuangYi 的个人 blog 以及 IBM developerWorks 的相关文章（及部分延伸链接）-- [[swordsp]] <<DateTime(2007-01-15T06:46:01Z)>>
 Line 150:
-  * ["ThinkIntoPython"]
  * ["PythonZhDoc"]
  * ["PythoNology"]
+  * [[ThinkIntoPython]]
  * [[PythonZhDoc]]
  * [[PythoNology]]
 Line 154:
-  * [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
+  * [[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
 Line 163:
-  * 修改中的[:swordsp/COTW/WoodpeckerIdxDoc:新版Python文档中心页面]
  * [:swordsp/PyResources:Python 资源中心]
  * [:swordsp/PyXML:Python 与 XML 资料搜集]
+  * 修改中的[[swordsp/COTW/WoodpeckerIdxDoc|新版Python文档中心页面]]
  * [[swordsp/PyResources|Python 资源中心]]
  * [[swordsp/PyXML|Python 与 XML 资料搜集]]
 Line 174:
-[[Include(/DisCuss)]]
+<<Include(/DisCuss)>>