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

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×
Saving this for later? Get the SlideShare app to save on your phone or tablet. Read anywhere, anytime – even offline.
Text the download link to your phone
Standard text messaging rates apply

Apache CloudStack Documentation

1,295

Published on

Published in: Technology
0 Comments
2 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total Views
1,295
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. ご清聴ありがとうございました。ドキュメンテーションの参加を お待ちしております!!

×