现在 Ruby China 的 wiki 功能并不完整,例如 [[]]
wiki 链接,只是一个带版本的文章页,并且限制了编辑,导致很多内容过时,但是新手却以为这是社区维护的内容而跟着做,结果引出一些问题。
我觉得可以把 wiki 迁移到 Github 上,开一个专门的 repo,使用它的 wiki 功能,自己开发维护 wiki 并不划算。迁移方法就是把文章复制粘贴过去,然后修改顶栏链接。
为了长期维护 wiki 内容,还需要一个 wiki team。考虑到 you can you up 原则,我做第一个成员,然后在活跃贡献者中吸纳更多成员。不过我的内容口味会比较严格,现有的一些口语化调侃类内容会去掉。对于 wiki,中立客观化内容会更持久。
对于内容贡献者我想说,基础类教程(工具搭建、使用等)一起写 wiki 的作用要大于在自己博客写教程,所以我提议想写基础教程的人能优先考虑贡献到 wiki。
如果我的提议能获得不少人支持,那么我就去 ruby-china 创建新 repo,开始整理条目,欢迎各位提出意见建议。
:metal:
可以呀! 这样有 Pull Request 以后就可以放心的让所有人参与修改了
这边的 Wiki 或许可以通过 git 拉取 Github Repo 的内容来生成,以便给那些还没学会翻墙的人看
github 的 wiki 本身也是一个 git 仓库,所以可以这样子:
先用 wiki 做起来吧,内容最重要,以后要换形式也不难。
我刚刚写了一份 https://github.com/ruby-china/wiki/wiki/RVM ,我还可以贡献 Capistrano,Vagrant,Vim,Ubuntu 12.04 上部署 Ruby on Rails 的资料,有人分担就最好了。
rbenv,Windows 上编译 Native Gem,Emacs,Sublime Text,RubyMine 是我不了解的,需要认领。
原来的 wiki 内容质量参差不齐,不想原样导入,新写的 wiki 希望重新整理语句。
Ubuntu 12.04 上部署 Ruby on Rails https://github.com/ruby-china/wiki/wiki/Ubuntu-12.04-%E4%B8%8A%E9%83%A8%E7%BD%B2-Ruby-on-Rails
我没测试过,发现错误的帮忙修改。
@Rei 我想按多级标题列一下 Ruby 应用,便于理清思路,例如分服务器端和浏览器端,浏览器端又分 HTML、CSS、JavaScript 这样,不知道可不可以
#34 楼 @kfihihc 属于实践类文章,觉得有人需要就写吧,以后要维护哦。
#35 楼 @swordray 我觉得这是不是 https://www.ruby-toolbox.com/ 做了?
#41 楼 @swordray https://github.com/ruby-china/wiki/wiki/Mac-OS-X-%E4%B8%8A%E5%AE%89%E8%A3%85-Ruby 这一页看不明白啊。
有几个问题:
现在的内容没考虑到别人怎么理解。
1、在 OS X 上 XCode、GCC、MacPorts 都必须下载安装,没有预装 2、除了数据库外其它都是必装的,不然没有编译环境,装不了 RVM。数据库我删了吧 3、XCode、GCC、MacPorts 都是必装的。RVM 和 rbenv 的区别比较应该算另外一个话题了,这个页面按我理解应该只说安装方法
1. Mac 预装 Ruby 了没? 3. 为什么需要 RVM,rbenv,现在列出来的层次就是每个都要安装一遍。
https://github.com/ruby-china/wiki/wiki/%E5%AE%89%E8%A3%85-Rails
这一页有类似的问题,
gem 'rails', github: 'rails/rails'
而不是 gem 'rails'
这两个页面给新人看绝对看不明白。我希望页面内容要考虑不了解 Ruby 的人如何理解(他/她可能有其他编程经验)。
https://github.com/ruby-china/wiki/wiki/%E5%AE%89%E8%A3%85-Rails
我想我们对 wiki 的看法还没有完全一致。从我对 wikipedia 的了解来看,wiki 主要是解释一下关键性的概念,实际上很多词条拿出来都可以写一本书了,都放在 wiki 里是有困难的。
我建议把词条和教程这两个不同需求分开,就像 wikipedia 和 wikimedia 的其它项目一样。
#48 楼 @swordray 没错,我们理念不一致。我觉得你写的内容就是随手笔记,完全没考虑别人怎么看。
如果第一个写的人只是随手填些内容,那么很难有人接手维护。现在 wiki 添加了一大堆页面,质量都不过关,如果我不是这次的发起者,那么我不如关掉页面写自己的博客。
易懂不一定需要长篇,举个修改例子:
不是
## [[Ruby]] 管理器
可以选择其一安装。
### [[RVM]]
\curl -L https://get.rvm.io | bash -s head --ruby
rvm install 2
### [[rbenv]]
TODO
而是
## 版本管理
如果需要安装多个版本的 Ruby,可以使用 [[RVM]] 或 [[rbenv]] 进行版本管理。
让读者知道用这个工具的目的是什么,并且利用已有的内容不要重复。
如果第一个写的人只是随手填些内容,那么很难有人接手维护
wikipedia 同样有这种现象,但是后面会不断有感兴趣的人去修改。我创建的页面也非常欢迎你继续改进。如果一开始就定为一个人写一个页面,并且一开始就要写好才能提交,以后就更难培养出 wiki 协作的氛围来了,最终有可能变成一个集体博客。
举个例子,刚才我在 Stack Overflow 问个问题,12 分钟后就有 3 个人把我的话从头到尾改了一遍
好的,我现在在 grape 里调用 update_without_password params params 里没有 avatar 会导致原来的 avatar 变成无效的,按道理来说如果没有 avatar 就不要去更新 user 的 avatar。实际测试的结果是会去更新 avatar
@Rei 我没想到我们的理念相差比较大,事先没沟通好就开始动笔,是我的责任。希望你按你的理念写出好的 wiki 来,我就把我写的部分撤了,以免影响到你的思路。
再次说声非常抱歉,以后会尽量提前沟通好。
ashie::Mash bio="fdccvbhh" email_public="true" location="\xE6\xB7\xB1\xE5\x9C\xB3" name="\xE7\x9C\x8B\xE7\x9C\x8B" tagline="" website="">
#64 楼 @swordray 没有金刚钻,不揽瓷器活是我的错。我的想法更像是 https://library.linode.com ,不应该用 wiki 旗号。
#68 楼 @Rei 果然 https://library.linode.com/ 跟我的思路完全不同,我看到 wiki 这两个字就奔 wikipedia 去了
@Rei 我更新了推荐书籍《Agile Web Development with Rails》相关的说明,麻烦您检查一下:https://github.com/ruby-china/ruby-china/wiki/%E4%B9%A6%E7%B1%8D%E6%8E%A8%E8%8D%90