历经最近为期五天的努力,四名KDE贡献者计划并写成了一本KDE入门参考手册。在此过程中,我们得到了来自几大慷慨组织的援助,付出了辛劳的汗水,并收获了许多心得体会。
Google提供给KDE一次极佳的机会,要KDE在一周内编撰与出版一本书,该项目于是应运而生。我们中的一名年轻开发者写好了一份提案,建立起了一个团队。Google接受了该提案。于是,我们开始了一个冒险、紧张与艰辛的工作之旅。
去年十月,我们四个充满激情的KDE贡献者组成的团队汇集在位于加州山景城的Google办公室,合力编撰一本KDE入门参考手册。只有一天时间!?幸好我们有来自 的Adam Hyde 的指导,和来自 这本书的作者Gunner的灵感。
一天的计划与组织之后,就是为期三天的艰苦工作:生成内容,编辑,编辑,还是编辑。在来自 的Andy Oram 的巨大帮助下,我们最终完成了
Beginner's Guide to KDE Development一书。之后,我们对它进行了概括,对所学的知识进行了讨论,并同时在线与通过 出版社出版出版了它。
推荐每个新的KDE开发贡献者阅读这本手册。它概括了贡献KDE的技术方面,并且是一本有价值的新开发者入门实训指导。该手册从开发者的视角提供了对KDE的深入观察,解释了如何检出已有代码,如何修改并提交更新。
目前该手册还只集中于KDE的编码方面。欢迎(鼓励)贡献者们拓展该手册,使之覆盖KDE社区的其他方面,并完善该书已有内容。我们当前正致力于发布后续版本的问题。
该书可在FLOSS Manuals 网站编辑,先须注册帐号。“Write”标签下的“All Manuals”菜单有一个“KDE-Guide”列表项。编辑即时生效,章节一经保存会立即反映到FLOSS Manuals 网站上。
另外,你也可以购买该书的 !是的,你没理解错,该书的硬拷贝已经可用。也可以下载其PDF或ePub格式文档,或在FLOSS Manuals 上在线阅读。
我们团队发现,产生这本书的整个体验是绝对美妙的。我们终于意识到了写出好的文档是何等的艰难。正因如此,我们向成百上千名在KDE 技术库、用户库以及为编写关联、实时文档而努力的辛勤工作者们脱帽致敬!
特别感谢Valorie Zimmerman 对整个故事以及该开发手册的巨大帮助。
相关评论(注释)存放于 ,晚些时候将会出版。
转载请注明: 英文原文: Published on 2012/02/05, By:
During a recent 5 day sprint, four KDE contributors planned and produced a handbook for beginning KDE developers. We had assistance from several generous organizations, worked hard, and learned a lot.
Beginning KDE Development (click for larger) The project started when Google offered KDE an amazing opportunity to write and publish a book in less than a week. One of our young developers developed a proposal and gathered a team. Google accepted the proposal. With that we were off on an adventure and some intense, hard work.
Last October, our team of four enthusiastic KDE contributors gathered at the Google offices in Mountain View, CA to write a guide on how to get started with KDE development. In five days!? Fortunately we had guidance from Adam Hyde from , and inspiration from Gunner of .
After planning and organizing for a day, there were 3 days of hard work: generating content, editing, editing and more editing—along with major assistance from Andy Oram of (thanks Andy!), we finalized the
Beginner's Guide to KDE Development. We then recapped, discussed Lessons Learned, and published, both online and printed by .
The guide is recommended for every new contributor to KDE development. It outlines technical aspects of contributing to KDE and is a valuable first point of contact for new developers. The guide offers insights into KDE from the developer's point of view, and explains how to check out existing code, modify it and submit patches.
Currently the guide only focuses on the coding aspects of KDE. Contributors are welcome (encouraged) to expand the guide to cover other aspects of the KDE Community as well as enhance the existing content in the book. We are currently working on how to release subsequent versions.
The book can be edited on the FLOSS Manuals site by creating an account. The "All Manuals" menu under the "Write" tab has a listing for "KDE-Guide". Edits are performed in real time and reflected on the FLOSS Manuals site as soon as the chapter is saved.
What's more, you can buy the book in print! Yes, you read that right, buy a in dead tree format. Download the PDF or ePub file, or read it online at Flossmanuals.
The team found that the entire experience was absolutely wonderful. We now realize how difficult it is to write good documentation. So our hats are off to the hundreds of people contributing to KDE Techbase, Userbase and writing relevant and up-to-date documentation.
Special thanks to Valorie Zimmerman for major help putting together this story and the Development Guide.
Comments are moderated based on . There will be a delay before they are published.