[SGLCTManual][讨论]项目书写规则约定及项目组织方法建议

[alexyu]

这是我根据GSH等项目的规则拟定的一份项目书写规则，请大家尽快讨论完善，这样便于项目开展实施

项目规则拟定
编写平台：http://sociallearnlab.org/wiki/index.php/SGLCTManual200905

共同tag：SGLCTManual ，SGLCTManual200905
解释：SGLCTManual  self-growing learning community technical manual 自生长社区技术进阶手册
200905为图书时间版本，将来再版时也会依据再版时间命名

tag应用范围：

• 邮件列表讨论：在相关邮件主题中添加 [SGLCTManual]，如本邮件标题 ”[SGLCTManual][讨论]项目书写规则约定“
• irc会议记录页面中的tag标识   如：http://code.google.com/p/sociallearnlab/wiki/SLSS200905Irc090506
• 使用社会性书签收藏相关资源时
• 使用社会性网络工具如twitter，blog推广传播项目时    附twitter中添加标签的方法：在文中任意地方加上   #SGLCTManual
• ……

章节命名：

全部使用英文以及阿拉伯数字

SGLCTManual200905Index
  |           |    |    


  |           |    |
  |           |    +-- 章节名,例: Gmail，第一个单词要大写


  |           |  


  |           +-- 时间版本：表示2009年5月版
  |
  +-- 图书工程缩写,例: SGLCTManual 自生长社区技术进阶手册 

图片命名及格式：

Image Charpt-No.png


|  |      |  +-- 统一使用PNG格式提供


|  |      +-- 章节附图序号


|  +-- 章节序号
+-- 统一标识字



例：
Image Gmail-2.png 意为 Gmail章节 2附图 
注：格式一定要统一用.png

图片标记方法：
包括标记框选择（方形，圆形……），颜色……
大家一起商讨

小组组长请注意：
组织编写好自己小组的项目日志，统一于该页面：
http://code.google.com/p/sociallearnlab/wiki/SGLCTManual200905Log
书写格式可以模仿已有的内容格式来写作，但是要标注清楚您是哪个小组的
大体格式：时间 小组名 进度
如有小组会议，可以仿照这个会议记录页面进行会议内容记录
会议记录文件名：SGLCTManualGmail200905Ircdate  也就是项目名+小组名+会议工具+具体时间，咩每个部分的第一字母要大些
http://code.google.com/p/sociallearnlab/wiki/SLSS200905Irc090506

项目组织建议

请各小组安排好自己的时间进度，最好能留出充足的时间拿给读者阅读获取反馈，也建议小组间形成合作关系，比如gmail组监督审查googlegroup组的进度，对googlegroup组内容进行评审建议等等。大家有好的协作推进方法也请在论坛中共享

充分利用论坛研讨
有问题直接在论他提出，也建议各个小组在论他中建立专门呢的讨论帖，这样，社区中的每个人都会看到你们的想法，会争取到更多的关注和支持

irc会议提议
如果在小组推进工作中有突出的疑难问题，可以在论坛中发帖申请召开集体irc会议，并提出议题，具体会议组织方法参考：
http://code.google.com/p/sociallearnlab/wiki/TipsCommunication

请大家共同商讨完善

--
余波

[alexyu]

补充，我已经将参与项目的各位朋友添加到了教育大发现工程平台编写用户之中，各位可以在其中编写修改文件
http://code.google.com/p/sociallearnlab/

另外，所有正式决议将会被书写到该工程平台的wiki，即
http://code.google.com/p/sociallearnlab/w/list
如 自生长社区技术进阶手册200905版图书写作项目日志
http://code.google.com/p/sociallearnlab/wiki/SGLCTManual200905Log

恳请大家一同编写维护


--
余波

[老玉米]

马上加入行动

2009/5/7 alexyu <y.bl...@gmail.com>

--
余波

--
我的好看簿：http://www.haokanbu.com/user/83567/

[alexyu]

希望大家对上述规则约定展开讨论，以形成共识

我想再提醒一下写作时间问题，计划成稿日期在5.20

我们在这段时间可能要经历几轮的写作，包括：
初稿形成
小组间评审，社区内外评审
围绕评审意见改稿
如此循环

而且，这中间还有一个问题，就是如何使得大家写作的内容在风格上尽量统一

我的想法：大家在完成初稿后，相互审校，从个小组章节内容中各取所长，组合形成最优写作风格方案

这样就需要制定一个较为统一的初稿截至日期，5.12日完成初稿如何，然后用两至三天的事件评审，吸取反馈，提出想法和建议，并围绕这些问题在召开一个irc快速会议，达成解决问题方案，然后在进行下一轮的写作修改

希望我们在创作出优秀内容的同时也形成一套合理的项目做事方式，欢迎大家讨论



--
余波

[leo bnu]

同意。文章是修改出来的，需要吸取多方意见

2009/5/7 alexyu <y.bl...@gmail.com>

[alexyu]

关于收集新手问题：

大家可以同时发帖到多个论坛，陈述项目用意，小组介绍，大纲安排，从而征集新手问题以及大纲修改建议，同时也可以吸引更多的人关注和参与

此外，还可以在
http://sociallearnlab.org/wiki 中查找相关章节，比如在社会性书签章节中就有学生的使用感受，意见反馈
http://sociallearnlab.org/wiki/index.php/Chapter_Social_Bookmark
还有庄老师的社会化学习课程班级论坛中也有不少相关资源
如：http://sociallearnlab.org/wiki/index.php/SLL2009S
http://sociallearnlab.org/wiki/index.php/PKM2008

还可以介绍给身边没有使用经验的朋友，通过这种方式获取一些反馈信息，等等，发挥大家的创造力

还推荐一个邮件列表：
淄博自生长学习社区邮件列表 
https://groups.google.com/group/zhcedu
我们项目中有些老师如翟老师耿老师都是淄博地区的老师和这个列表的成员，目前这个列表中的成员也在积极的学习社会化软件工具的使用，我们也可以在这里征求一些问题，并使用创造的内容带动这个社区的进步，在这个过程中吸取建议，完善图书内容

大家一起努力，让项目更有价值，让更多的人从中受益！





--
余波

[Luke Zhang]

建议设一个检查员，检查各小组的格式规范，如有问题发gmail通知个人改正。


--
Chunlei Zhang
Ph.D. candidate
Major: Curriculum & Teaching
Scholar Interests: science education; teacher training ; teacher knowledge; pck; concept map
Biology Teaching Club：http://groups.google.com/group/bioteahouse

[alexyu]

2009/5/7 Luke Zhang <luk...@gmail.com>

建议设一个检查员，检查各小组的格式规范，如有问题发gmail通知个人改正。
 

建议也可以小组间相互监督，比如gmail组监督googlegroup组，googlegroup组监督xx组，如此

另外，小组一定要及时的对外汇报小组紧张情况，形成群体监督机制

--
余波

[alexyu]

群体智慧，创作图书内容
开放透明，吸引更多人参与
创作中推广，新人与写作同时受益
经验方法沉淀，寻求自生长社区之路

--
余波

[alexyu]

大家可以把写作中收集到的资源发布在论坛以及添加到项目页面

也建议大家及时汇报小组进展以及发布创作内容，这样可以边写作边吸取反馈信息

[wenxia kang connie]

2009/5/7 alexyu <y.bl...@gmail.com>

这是我根据GSH等项目的规则拟定的一份项目书写规则，请大家尽快讨论完善，这样便于项目开展实施

--
余波

==> 很好。整体的统一、规则、循环修改方式，安排得都很细致到位。

不过，我还有一个想法，我们的界面能否再友好一些呢？总觉得Goolegroup的页面也好，wiki页面也好，界面的友好性，包括美观和结构化元素不是那么理想。

--
Wenxia Kang （Connie）
Master candidate
School of Educational Technology
Beijing Normal University
Phone 1314-133-8993
email: conn...@gmail.com
http://wenxiakang.wordpress.com

[汤富源]

有类似同感

> 总觉得Goolegroup的页面也好，wiki页面也好，界面的友好性，包括美观和结构化元素不是那么理-想。

> --
> Wenxia Kang （Connie）
> Master candidate
> School of Educational Technology
> Beijing Normal University
> Phone 1314-133-8993

> email: connie...@gmail.comhttp://wenxiakang.wordpress.com

[bettywong]

==关于项目组织==
我们Diigo小组约定了小组共同Tag，即SGLCTManual_Diigo，将收集到了相关网页资源在Diigo中用小组共同Tag标识进行分
享。

==关于编写==
*对规则还不是很清晰，编写过程中可能会有参考资料的引用，关于引用的标注该如何规范？
*为了对文字进行排版美化，可能会涉及到字体、字号及颜色的调整，目前没找到太好的方法，只能通过HTML来改，不知哪位大牛有更好的方
法？

[xiuli]

这是一个提醒，SGLCTManual200905写作时的命名规则。
http://sociallearnlab.org/wiki/index.php/SGLCTManual200905

[alexyu]

不过，我还有一个想法，我们的界面能否再友好一些呢？

总觉得Goolegroup的页面也好，wiki页面也好，界面的友好性，包括美观和结构化元素不是那么理想。

==> 关于GG，wiki的友好性，我们可以一同商讨出具有可操作性的改善方法

wiki。我在前几天发布项目的时候同时发布了模板，使用方法参考：http://tinyurl.com/cske3z   中wiki模板部分，这可能会给大家减轻一部分的负担。我也准备为社区wiki安装一些扩展，实现tag等功能
关于扩展插件，普及下知识：http://www.kevenlw.name/archives/527
大家也可以提议，看我们需要哪些扩展，最好直接给出相应的链接

GG. googlegroups讨论我主要通过gmail管理，但是对于刚刚进入论坛的朋友可能会有很大困难，不容易通过那么多凌乱的讨论帖也页面了解到论坛及社区，这就需要对论坛中的资源作出优化和调整，给出相关导航，等下我会专门发帖，收集意见，建立相关工作小组来为大家服务

*为了对文字进行排版美化，可能会涉及到字体、字号及颜色的调整，目前没找到太好的方法，只能通过HTML来改，不知哪位大牛有更好的方
法？

==> 我可能忽略了很重要的一点，就是为什么选择wiki作为图书写作平台，图书编写中wiki发挥什么作用？

为什么选择wiki：为了便于协作和版本及历史记录管理，我们选择了wiki，而且，wiki可以让整个过程更为开放、透明，参与度更高，wiki这种所想即所得的结构化文本也便于后期在多种环境下制作美工及排版

我们在wiki上做什么：图书编辑中，wiki主要用于协作，创作内容。至于排版，美工这些东西是在其他环境下完成的。

在哪里排版？

严格的说排版，美工不是我们的事情，如果是需要出版，出版社也应该负起排版美工的责任，这是非常专业的事情，但是如果我们要发行电子版或者自己引发一些简单的纸质版本，也需要自己去做基本的排版工作，这部分工作大家可以结合自己习惯的工具去完成，最后输出pdf等统一格式文档就好。请高手参与研讨指正！

参阅：
过去我们在GSH图书编写项目中有约定，可以参考下面网页中wiki部分
http://code.google.com/p/sociallearnlab/wiki/ZqSayWYTIWYG

==关于编写==
对规则还不是很清晰，编写过程中可能会有参考资料的引用，关于引用的标注该如何规范？

==> 谢谢提醒，在模板中添加了参考资料部分
参考：http://sociallearnlab.org/wiki/index.php/Template:Regular
大家暂时按照这个方法使用

求助：
在wikipedia中，参考文献的调用使用的是添加代码自动生成的方法
见http://en.wikipedia.org/wiki/Wikipedia:Footnotes
他们使用了这个扩展：http://www.mediawiki.org/wiki/Extension:Cite/Cite.php

但是我安装启用后，使用该方法添加相应代码预览却进入空白页面，系统也没有任何错误提示，不知道是什么问题，特向高手求助

--
余波

[alexyu]

提醒各小组，在写作中要注意不断结合项目目标来审查小组进展

写作内容基本原则：

基础，简单，一个问题一个教程

从新手角度思考，以及掌握相应工具一些必须的重要功能

--
余波

[Zoom.Quiet]

2009/5/9 alexyu <y.bl...@gmail.com>:
...

> 求助：
> 在wikipedia中，参考文献的调用使用的是添加代码自动生成的方法
> 见http://en.wikipedia.org/wiki/Wikipedia:Footnotes
> 他们使用了这个扩展：http://www.mediawiki.org/wiki/Extension:Cite/Cite.php
>
> 但是我安装启用后，使用该方法添加相应代码预览却进入空白页面，系统也没有任何错误提示，不知道是什么问题，特向高手求助

建议打开调试模式，看后台输出的日志信息；一般来说PHP 的代码插件出问题的地方只有:
- 安裝不正确，没有相应的修订DB
- 安装目录不正确,没有真正的起作用
- 安装后文件权限不正确,无法执行

--
http://zoomquiet.org
'''过程改进乃是催生可促生靠谱的人的组织!'''
多吃菜,少喝酒;听老婆的话,跟党走!

[alexyu]

大家在写作是可以充分利用教育大发现社区内部已有的资料，包括：
邮件列表中的讨论
https://groups.google.com/group/sociallearnlab

googlecode中的沉淀
http://code.google.com/p/sociallearnlab/w/list

社区wiki中的资源
http://sociallearnlab.org/wiki/

……

而且，如果引用，一定要注明引用地址
如果是从其他网站引用的资源，也一定看清楚对方的使用的版权协议（如具体的CC协议等），以免造成不必要的纠纷

参考文献格式可以直接用模板
http://sociallearnlab.org/wiki/index.php/Template:Regular


--
余波

[alexyu]

wiki编写小技巧：用好讨论页

wiki编写中，建议大家经常相互查看别的成员编写的成果，取长补短，同时，如果有建议，可以充分利用页面讨论页展开讨论，并在自己的建议后面签名

如：http://tinyurl.com/p8u32s

--
余波

[alexyu]

编写小提醒：

编写的时候，文字内容尽量通俗简单，避免使用一些专业词汇，比如“社会性软件”，“web2.0理念”等……因为图书的受众是那些新手，他们对这些词汇是比较陌生的，不要让他们在从事技术实践之前就产生心理上的恐惧和压力

总之，从新手出发，基础，简单，基于具体问题，通俗的讲解介绍就好


--
余波

[alexyu]

大家暂时不用太考虑排版什么的问题，12、13号能把初稿内容创作出来最好

因为建立公共图片库有些麻烦，所以图片使用最好个人建立图库，比如使用picasa 外链图片
http://picasaweb.google.com/home

先存放到个人图库，出版时大家把图片同一汇集就好


--
余波

[alexyu]

今天是12号，已经临近部分小组制定的初稿完成日期，大家加油啊！

大家也可以把已经写好的内容分享大SLL论坛，淄博社区等地方，在传播的过程中不断吸取反馈，优化

--
余波

[alexyu]

大家已经写作了不少内容，有些小组也完成了初稿写作，不管现在写出了多少，大家应该对项目协作有了不少认识和体会，也可能会有更多的问题和收获，建议大家抽空在各自小组讨论帖中晒晒撒

看大家什么时候有空，再召集一个快速irc会议，把写作中的问题讨论下，从而展开下一轮写作

irc会议先从问题收集开始，大家有时间了互访一下其他小组的创作内容，广提建议


--
余波

[alexyu]

为便于传播本项目，项目介绍和链接已经放在了社区wiki主页顶端，请大家协助推广

http://sociallearnlab.org/wiki/

 

--
余波

[alexyu]

提醒大家书写维护自生长社区技术进阶手册200905版图书写作项目日志

http://code.google.com/p/sociallearnlab/wiki/SGLCTManual200905Log


= 项目进展 =

* 20090503 发起《社会化学习软件平台200905版》图书编写项目  http://tinyurl.com/czlcrl

* 20090506 项目会议 http://code.google.com/p/sociallearnlab/wiki/SLSS200905Irc090506

* 20090507 发起讨论 [SGLCTManual][讨论]项目书写规则约定及项目组织方法建议  http://tinyurl.com/dfkwno

* 20090507 Gmail小组推进计划发布   [SGLCTManual][Gmail小组]Gmail小组编写讨论 
http://tinyurl.com/cj7qvw

* 20090507 Gmail小组征求gmail使用问题以及写作大纲建议
广泛征求意见：Gmail如何来学习？或者哪些需要学习？  http://tinyurl.com/dzbhlf

*20090507  Diigo小组推进计划发布   [SGLCTManual]Diigo小组编写讨论
http://tinyurl.com/cu6582

*20090506   Blog组主题研讨地址：http://tinyurl.com/ceqdvv

*20090506   好看簿组主题研讨地址：http://tinyurl.com/r24scn

*20090506   Twitter组主题研讨地址： http://tinyurl.com/oyg5a8

* 20090511 Gmail小组在SLL，淄博，西部阳光等多个论坛发布部分写作内容，开始在推广中吸取内容审查和反馈   [SGLCTManual][Gmail小组]Gmail小组编写讨论  http://tinyurl.com/cj7qvw

* 20090514 大部分小组完成初稿写作，图书编写进入反馈修改阶段。为了更好推动项目运行，项目开始征集写作中出现的问题，并将围绕主要问题展开irc会议讨论  [IRC]《自生长社区技术进阶手册》项目IRC会议议题征集  http://tinyurl.com/qxnb7d


--
余波

[alexyu]

参与图书项目的朋友可以尽可能的推广和传播这本图书，在推广中吸取更多的反馈意见，以便完善图书内容

项目周边的关注者是辅助项目推进完善的优秀同盟，大家一起努力，积极主动拓展“关注圈子”


--
余波