Your SlideShare is downloading. ×
Apache CloudStack Documentation
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×

Introducing the official SlideShare app

Stunning, full-screen experience for iPhone and Android

Text the download link to your phone

Standard text messaging rates apply

Apache CloudStack Documentation

1,224
views

Published on

Published in: Technology

0 Comments
2 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total Views
1,224
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
21
Comments
0
Likes
2
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. #osc12cloud ドキュメンテーションに参加しよう シトリックス・システムズ・ジャパン(株) マーケティング本部 北瀬公彦 @kkitase
  • 2. CloudStack CollaborationConference in ラスベガス• 世界中のCloudStackコミュニティが 一同に集まる国際カンファレンス• 11/30 – 12/2 までの間、 ラスベガスのヴェネチアンホテルにて開催• 50以上のセッションᵒ アーキテクチャ、プロセス、ドキュメンテー ション、エコシステム、構築系等ᵒ ハッシュタグ #ccc12ᵒ 録画は後程アップロードされる予定ᵒ 全てslideshareにて資料は公開参考: http://www.aarondelp.com/2012/12/links-to-everything-cloudstack.html
  • 3. Apache CloudStack Doc ウェブサイトhttp://incubator.apache.org/cloudstack/docs/en-US/index.html
  • 4. Pre-Apache CloudStack Doc ウェブサイトhttp://docs.cloudstack.org/
  • 5. CloudStack ドキュメンテーションの歴史• 2012年4月にCloudStackをApache Software Foundationに、Citrixが寄贈• Citrix テクパブチーム、既存のドキュメントを寄贈• 2012年12月現在、CloudStackはASFのインキュベーションプロジェクト• CloudStackプロジェクトには、様々なドキュメントが既に存在 ᵒ インストールガイド、簡易インストールガイド、管理者ガイド等 ᵒ Word、PDFで生成されている しかし、OSSのプロジェクトでは、 ………… 翻訳しにくい ………… 管理にしくい
  • 6. Word/PDF  Docbook XMLへ変換中• Docbook XML採用• Wordから、Docbook XMLへ変換 – マニュアルで変換してます。。。• 色んなツールもあったけど、結局カットアンドペーストでやってます。。。 – ooo2sdbk, aka Bellots Convertisseur: Seems to require a lot of customization; and is in French – pcwTextExportr: Tried, didn’t work – OpenOffice "save as Docbook XML" feature, requires you to download XSLT & find instructions for XML filter: Download links = broken – YAWC: “no longer provide support” = likely converts to an outdated Docbook format – Hire a format conversion service – Automate using OOo SDK• マニュアルも悪くない – ドキュメンテーションのレビューもできる、デザインを改善したり、不要なものを落としたり。。。
  • 7. Docbookcwiki.apache.org/confluence/display/CLOUDSTACK/Documentation+Team
  • 8. Doc Git Repogit-wip-us.apache.org/repos/asf/incubator-cloudstack.git/docs
  • 9. Publicanfedorahosted.org/publican/• FedoraのプロジェクトでRed Hat社等でマニュアルを生成する際に 使われている – PDFやHTMLフォーマットへ出力• 翻訳用にPOファイルを生成• ユーザーガイド jfearn.fedorapeople.org/en- US/Publican/2.7/html/Users_Guide/index.html
  • 10. 翻訳しよう!Transifex 最初に言語を作成する場合、https://www.transifex.com リソースタブ  いずれかのリソースprojects/p/ACS_DOCS/  新しい翻訳を追加 でリソースを作成する 言語は、Japanese (japan) ja-JP を指定する
  • 11. ドキュメントバグをレポートしよう! Jiracwiki.apache.org/confluence/display/CLOUDSTACK/How+to+File+a+Documentation+Bug 注意: Component/s: Doc
  • 12. ドキュメントバグを修正しよう!Review Boardhttps://reviews.apache.org/groups/cloudstack 余力があれば、ドキュメントの 修正にもチャレンジしよう。 ドキュメントを修正すれば、 Review Boardにパッチをのせ、 コミッターがその修正をコミッ トするのを待とう。
  • 13. 継続的インテグレーションツール Jenkinshttp://jenkins.cloudstack.org コミット等があれば、 自動的にビルドが行われ PDFが生成される
  • 14. リファレンス• ウェブ: – 本家: http://cloudstack.org – 日本語: http://cloudstack.jp• メーリングリスト: – cloudstack-dev@incubator.apache.org – cloudstack-users@incubator.apache.org – 日本語: users@cloudstack.jp• IRC: – #cloudstack on irc.freenode.net• Facebook: – www.facebook.com/groups/cloudstack/ – www.facebook.com/cloudstackjapan• ドキュメントバグのレポートの方法や、貢献について – cwiki.apache.org/confluence/display/CLOUDSTACK/How+to+File+a+Documentation+Bug – cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+Documentation+Contributors+Overview – cwiki.apache.org/confluence/display/CLOUDSTACK/Documentation+Team
  • 15. ご清聴ありがとうございました。ドキュメンテーションの参加を お待ちしております!!