{技术手册定稿}项目实施方案提议

[alexyu]

大家好，

这里是技术手册定稿项目实施方案提议，希望大家一起参与讨论，将其完善。也请大家在技术手册定稿工作中，保持对该主题贴的关注，本贴会不断回复更新，对大家顺利完成工作提供支持

声明：以后有关技术手册定稿工作的讨论邮件，可以在标题中使用{技术手册定稿}标签，如本邮件

修改方针──基本不做大幅度内容增删调整，重点审查：章节结构是否合理可以满足新手入阶，技术环节讲授是否清晰准确，文章内容结构、逻辑是否合理，语句表达通顺无错别字，外部内容引用是否规范合理，图片是否清晰，是否遵守图片使用规范（图片规范： http://tinyurl.com/njes49）

具体的工作方法提议：

1.集体巡查，合力完成每个章节的审查。

2.单独发布每个章节的讨论贴，在论坛充分收集反馈建议，然后在IRC集体讨论。每两天一个irc专题会议，当然，不要求大家参与所有章节的讨论，有时间尽量参加即可。
--讨论贴标题：{技术手册定稿}{Gmail}

IRC会议时间：每晚8点IRC会议，时长：1~1.5小时  把握好时间，
IRC会议地点及技术使用：http://code.google.com/p/sociallearnlab/wiki/UsageIRC
会议组织方法参考：会议33制 http://code.google.com/p/sociallearnlab/wiki/ZqSayCommunityCommunicate

IRC会议目的，想达成的成效：
针对论坛中提出的问题提出具体可行的修改方案，也可以是在会议中讨论发现问题，并得出修改方案

3.每个章节有专人负责，具体工作包括：组织大家在相关主题贴中讨论，整理讨论信息，主持章节irc会议，组织会后具体内容修改工作，并负责记录工作日志
项目工作日志页面：http://code.google.com/p/sociallearnlab/wiki/SGLCTManual200905Log
大家主动跟提报名，担当章节负责人的工作啦，已经确定的章节负责人：
wiki：庄秀丽
diigo：王莹
gmail：余波

4.参会者一定提前阅读相关章节以及论坛讨论贴内容

5.irc会后章节内容修改进度监督方法（目的是保证讨论后需要修改的内容被及时修改完善）

在会议结束之后，总结一下会议达成的意见建议，当场分工，然后基本保证在1~2天内实施完毕。最后由王莹余波等人负责最后一遍审查。也欢迎任何一个朋友参加审查。庄秀丽负责审查最后一稿。

在每次irc会议前，用5~10分钟总结上一次会议中提出意见的修改进度

6.不断提炼工作中的问题，总结经验，完善更新该工作帖


具体章节会议时间：（每晚8点， 先从Gmail章节开始，不断总结沉淀会议组织方法经验，以提高项目工作效率）

7月9日 Gmail

7月11日 GoogleGroups

7月13日 Blog 重点完善

7月15日 Haokanbu

7月17日 Wiki

7月19日 Diigo

7月21日 Twitter

7月23日 GoogleReader 重点完善


奖励致谢机制
（1）凡参与者项目，在最后致谢页中署名
（2）重点标注图书创作过程中重要的贡献者
同时，教育大发现社区希望借鉴开源社区类似项目的做法，在这里也向各位朋友征集相关建议


--
余波

[alexyu]

大家还可以查看 北京师范大学暑期实践周全体同学 对手册内容的修改讨论，他们绝大多数都是新手，提出的问题很有参考价值

http://tinyurl.com/mwnaxa

[alexyu]

090709 Gmail章节定稿irc会议经验分享：

虽然会前重点和和一些朋友做了沟通，并且专门通过gtalk留言等方式通知会议时间，但是参与的朋友依然比较少，而且，一些朋友因为时间等原因没有能在会前系统的查看具体的章节内容，因此，会议也采用了较为灵活的方式，让大家利用会议的一小时时间自由精读gmail章节内容，发现问题立刻在irc提议，并要求给出修改建议，其它朋友也可以对每条具体的提议进行补充或者发表自己的意见，用这种方法，会议也取得了较好的效果，收集到了很多好的建议

此外会议结束前，制定了详细的修改任务分工以及时间表，以及审查人，并且要求在修改的时候不断的在相关讨论贴中汇报修改进度，也鼓励大家继续提出修改建议

以上，简单总结

irc会议记录：http://code.google.com/p/sociallearnlab/wiki/SGLCTManual200905Irc090709


--
余波

[alexyu]

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

090709 Gmail章节定稿irc会议经验分享：

虽然会前重点和和一些朋友做了沟通，并且专门通过gtalk留言等方式通知会议时间，但是参与的朋友依然比较少，而且，一些朋友因为时间等原因没有能在会前系统的查看具体的章节内容，因此，会议也采用了较为灵活的方式，让大家利用会议的一小时时间自由精读gmail章节内容，发现问题立刻在irc提议，并要求给出修改建议，其它朋友也可以对每条具体的提议进行补充或者发表自己的意见，用这种方法，会议也取得了较好的效果，收集到了很多好的建议

但是，还是希望大家可以在会议前充分准备，精读手册内容，这样会议会更有成效

希望这些经验对大家有所帮助

--
余波

[alexyu]

大家还可以查看 北京师范大学暑期实践周全体同学 对手册内容的修改讨论，他们绝大多数都是新手，
提出的问题很有参考价值

http://tinyurl.com/mwnaxa

上次发布的这个内容可能很多朋友都没有注意到，再次发布下，并给出每个具体的连接，请大家认真阅读相关内容

http://tinyurl.com/mwnaxa

• Googlereader小组：

wiki讨论页 http://sociallearnlab.org/wiki/index.php/Googlereader-group

班级论坛讨论页面：Gmail小组意见交流帖

• 好看簿小组：

wiki讨论页 http://sociallearnlab.org/wiki/index.php/Talk:SGLCTManualHaokanbu200905

班级论坛讨论页面：好看簿小组的Brainstorm

• twitter小组：

wiki讨论页 http://sociallearnlab.org/wiki/index.php/Talk:SGLCTManualtwitter200905

班级论坛讨论页面：Twitter小组

• wiki小组：

wiki讨论页 http://sociallearnlab.org/wiki/index.php/Talk:SGLCTManualWiki200905

班级论坛中的研讨 【Ｗiki小组】工作进展交流

• gmail小组：

wiki讨论页 http://sociallearnlab.org/wiki/index.php/Gmail.public.wangyi

班级论坛中的研讨 Gmail小组意见交流帖

• blog小组：

wiki讨论页 http://sociallearnlab.org/wiki/index.php/Talk:SGLCTManualBlog200905

班级小组讨论帖

• googlegroups 小组：

wiki讨论页 http://sociallearnlab.org/wiki/index.php/GoogleGroups2009

班级论坛中的研讨 关于学习过程的一些想法

• Diigo 小组：

wiki讨论页 http://sociallearnlab.org/wiki/index.php/SGLCTManualDiigo200905

班级论坛中的研讨 Diigo小组讨论贴

--
余波

[alexyu]

声明：

好看簿小组irc会议时间调整至 7月21号 晚8点

twitter小组irc会议时间调整到 7月15号 晚8点

也就是twitter小组和好看簿小组时间对调，敬请留意！


--
余波

[alexyu]

图书修改建议：每个章节中，章节概述部分需要起到统帅全章的作用，把后面的各个技术讲授小结串联起来

比如在gmail章节中，概述部分应该点出gmail “办公集成”，“会话终端”等特点价值，用这些特点和后面的技术环节联动，用技术小节用来支撑这些特点


修改中发现的一些问题也汇报下：

问题：
修改中最麻烦的地方依然出现在图片上，

包括图片标注修改和图片命名修改

图片标注修改：参考图片标注规范即可，但是很花费时间 http://tinyurl.com/njes49

图片命名修改：依然参考上面的规则即可，但是因为图片命名是和章节排名以及在小节中出现的顺序排名挂钩的，所以一旦文章中需要添加或者删除图片，全部图片顺序都要再次拍过，如果文章章节顺序发生调整，修改量更是巨大。因此，需要约定更加适合社区图书创作的图片命名规范

--
余波

[xiuli]

2009/7/11 alexyu <y.bl...@gmail.com>:
> 图书修改建议：每个章节中，章节概述部分需要起到统帅全章的作用，把后面的各个技术讲授小结串联起来

==〉这是一个非常好的建议，各章概述可以采用这个规则。

> 修改中发现的一些问题也汇报下：
>
> 问题：
> 修改中最麻烦的地方依然出现在图片上，
> 包括图片标注修改和图片命名修改
>
> 图片标注修改：参考图片标注规范即可，但是很花费时间 http://tinyurl.com/njes49
>
> 图片命名修改：依然参考上面的规则即可，但是因为图片命名是和章节排名以及在小节中出现的顺序排名挂钩的，所以一旦文章中需要添加或者删除图片，全部图片顺序都要再次拍过，如果文章章节顺序发生调整，修改量更是巨大。因此，需要约定更加适合社区图书创作的图片命名规范
>

==〉这些经验可以在Googlecode页面上系统地存留下来。
http://code.google.com/p/sociallearnlab/

[alexyu]

图片修改、标注规范以及标注方法步骤请参考：
http://tinyurl.com/njes49




--
余波

[小石]

刚才翻来覆去想图片的命名规范，是否应该去掉章节、图片序号，而根据每张图片属于什么软件，又要介绍什么功能，可能该功能还包括什么具体的操作，以下面的方式来命名：

工具_logo / 工具_功能 / 工具_功能_操作

比如Gmail概述页面中，
http://sociallearnlab.org/wiki/index.php/SGLCTManual200905Gmail-1

Gmail的logo：Image Gmail-1-1，
直接用Gmail_logo？

而Gmail打开以后，默认打开收件箱的界面：Image Gmail-1-2，
直接命名为Gmail_inbox?

想法还不是十分清楚，大家可以再讨论一下。

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

--
小石，
Editor, SocialLearnLab.org
131 4617 2275（Beijing）
xia...@gmail.com（eMail/Gtalk）
-------------------
Twitter: @changqingteng
Blog: http://sociallearnlab.org/xiaoshi
Profile:http://xiansf.wealink.com
PicBlog: http://xiaoshi.haokanbu.com
Bookshelf: http://www.douban.com/people/youthstudio
Digest: http://diigo.com/user/xiansf
-------------------
教育大发现
http://SocialLearnLab.org
走向社会化学习
--
TEDtoChina
http://TEDtoChina.com
科技、娱乐与设计的盛会
--
多背一公斤
http://1kg.org
公益旅游&乡村教育
--
PLP爱心传递工程
http://PassLove.org
知识改变命运，爱心传递希望
--

[alexyu]

irc会议经验总结：

昨天在进行googlegroups章节定稿讨论irc会议的时候，建立了一个googledocs在线文档，邀请所有的参会者参与编辑
好处：方便及时协作总结会议结果，也方便一些任务分工认领
需要注意的是：需要把文档中的信息修订到会议记录中

如果irc参会者较少，可以在会议进展的同时及时向论坛发布讨论纪要，这样也相当于是把会议在论坛内直播，以吸引更多不在会场的参与者参加即时讨论，也可以给不能正常登录irc会议室的朋友参与会议讨论的机会。所以，建议今后组织irc会议的时候及时在论坛内发布会议进展纪要

[alexyu]

涉及到英文服务/功能的地方需要添加中文解释说明，

比如twitter申请这节 http://sociallearnlab.org/wiki/index.php/SGLCTManual200905Twitter-2

如果图片太多修改不方便的话 可以用文字说明下，比如 点击 Get Startde-join（开始加入）按钮……


--
余波

[吴长城]

我发现有些图片有问题，截图太大，比如用到Gmail，把浏览器整个都截了放到章节中，占地方，也影响读者视线。
图片中的美观：如图片截取点取了半个文字等，最好沿着图本身的线条截图，自然会美观很多！

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

--
吴长城
Email: chengch...@gmail.com
Skype: hardwork_06
QQ: 3045129191
Twitter: http://twitter.com/chengcheng1098
Bookmark: http://del.icio.us/wuchangcheng
Haokanbu: http://chengcheng.haokanbu.com
Wealink: http://hardwork06.wealink.com
http://www.slideshare.net/wuchangcheng
http://www.flickr.com/photos/wuchangcheng/
http://www.youtube.com/user/chengcheng1098
http://friendfeed.com/chengcheng1098

[alexyu]

2009/7/20 吴长城 <chengch...@gmail.com>

我发现有些图片有问题，截图太大，比如用到Gmail，把浏览器整个都截了放到章节中，占地方，也影响读者视线。
图片中的美观：如图片截取点取了半个文字等，最好沿着图本身的线条截图，自然会美观很多！

同意
也给出一个案例小节：
http://sociallearnlab.org/wiki/index.php/SGLCTManual200905Gmail-2
以后的截图就不在调整修改了，今后截图可以采纳这一建议


另外，如果有的截图太大影响阅读，可以参考这里的方法进行图片显示大小调整：
http://zh.wikipedia.org/wiki/Help:%E5%9B%BE%E5%83%8F#.E8.B0.83.E6.95.B4.E5.A4.A7.E5.B0.8F

比如 wiki中的一幅图片  [[File:wiki.png]] 它过去宽度是1000像素，我们希望把让它的显示大小调整为宽度700（长度也随之变化，等比缩放），只要将链接代码改为[[File:wiki.png|700px]] 即可

参考案例：http://sociallearnlab.org/wiki/index.php/SGLCTManual200905Blog-6
这一章节的原始图片都很大，后来经过代码处理实现缩放

图片宽度不要超过800像素（800px）

--
余波

[alexyu]

如果大家发现wiki页面超过三个大标题（二级标题，三级标题……）时仍然无法自动生成目录，请检察正文内容上方的代码中是否包含 “__NOTOC___” ，如果有的话去掉他就可以了

目前发现在部分页面上方的 “Wiki基本编辑格式指南” 这句话的语句代码包含了 “__NOTOC___”  
其对应代码为：
<font color="blue">[http://sociallearnlab.org/wiki/index.php/%E5%9F%BA%E6%9C%AC%E7%BC%96%E8%BE%91%E6%A0%BC%E5%BC%8F%E6%8C%87%E5%8D%97__NOTOC___ Wiki基本编辑格式指南]</font>
改为：
<font color="blue">[http://sociallearnlab.org/wiki/index.php/%E5%9F%BA%E6%9C%AC%E7%BC%96%E8%BE%91%E6%A0%BC%E5%BC%8F%E6%8C%87%E5%8D%97 Wiki基本编辑格式指南]</font>









--
余波

[betty]

可是左右两边都有个目录,显得好乱阿.....

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

--
Betty Wong,

School of Educational Technology,
Beijing Normal University

Blog:http://sociallearnlab.org/bettywong
Skype: bettywong0829
Twitter: http://twitter.com/bettywong
Bookmark: http://del.icio.us/bettywong
We@Link: http://bettywong0829.wealink.com/
MyBlogLog: http://www.mybloglog.com/buzz/members/bettywong/

[alexyu]

2009/7/20 betty <bettyw...@gmail.com>

可是左右两边都有个目录,显得好乱阿.....

页面编辑者自己决定

如果不需要显示目录，就在页面最上方加上代码：
__NOTOC___

--
余波

[alexyu]

请大家抓紧时间，马上就到月底了，我们争取在本周完成定稿工作


--
余波

[alexyu]

项目进度汇报：

20090719 《村落学习——技术环境手册》Gmail章节完成定稿

20090723 《村落学习——技术环境手册》diigo章节完成定稿

20090723 《村落学习——技术环境手册》twitter章节完成定稿

20090805 《村落学习——技术环境手册》wiki章节完成定稿

20090805 《村落学习——技术环境手册》GoogleReader章节完成定稿

20090805 《村落学习——技术环境手册》Haokanbu章节完成定稿

项目日志：http://code.google.com/p/sociallearnlab/wiki/SGLCTManual200905Log