PDA

View Full Version : 最初にお読みください:ガイドライン



yuki
1 Mar 2009, 10:13 PM
「Ext Japan:ヘルプ」フォーラムを利用するに際して下記のことを予めご確認くだささい:



分かりやすいタイトルをつける
具体的にどういう問題が発生しているのかを端的にあらわすタイトルをつけましょう(「教えてください」や「助けてください」みたいな曖昧なタイトルは敬遠されてしまいがちです)。また、具体的なタイトルを付けることによって、同じことで困っている人(あるいは困っていた人)が後で検索しやすくなるはずです。

スクリーンショットを添付する
Ext JSを使った開発では、GUIの挙動がおかしい、レイアウトが思ったとおり動作しないというトラブルに直面することがよくあるかと思います。その場合、スクリーンショットを添付可能なのであれば、添付してみてください。もしかしたら一発で回答が得られるかもしれません。

実際のデモ・サンプルページへのリンクを貼る
スクリーンショットだけでは解決できない問題も実際に動く画面を見ればすぐに解決する場合もあります。もし、オンライン上にデモ・サンプルをアップすることが可能であれば、そのページへのリンクを記載してください。

サンプルコードを添付する
ただし、トラブルが社内システムや受託の開発案件で発生した場合、スクリーンショットもリンクも無理な場合がほとんだと思います。その場合は、そのトラブルを再現する(そして可能な限り問題箇所が絞り込まれていて、できるだけコンパクトな)サンプルコードを添付してください。その際、できる限り、サンプルコードはダウンロードしてWebサーバーにアップするだけで動くような構成にしてください(例;例えば、ext-all.jsやext-all.cssなどのファイルの場所は各環境で異なるので、そういったライブラリ関連のファイルについてはCacheFly*を利用するなど)。

問題と思われるコードを記載する
あるいは、サンプルコードを用意するまでもなく、単に問題と思われる箇所だけを抜き出して投稿するだけでも解決する場合があります。その場合は、必ずソースコードを「CODE」タグで囲ってください(エディタのツールバーの中にある、「#」と「<>」と「php」と書いてあるアイコンを使えば、ソースコードを綺麗に埋め込むことができます)

Firebugのエラーメッセージを記載する
他には、Firebugで表示されるエラーメッセージも併せて書いておけば、それにピンと来る人がいるかもしれません。できるだけエラーメッセージも書くようにしてください。

動作環境
動作環境によって発生する問題もありますので、使っているExt JSのバージョン、ブラウザの種類・バージョン、OSについても併せて書くようにしてください。

スレッドを分ける(3/4追記)
スレッドが長くなっていくと、途中で別の質問ややり取りが始まって最初につけたスレッドのタイトルと違う内容のものなってしまうことがあります。後々、検索するときに見つけにくくなってしまうので、スレッドのテーマと違う内容のものについては別スレッドを新しく立てるようにしてください。

スレッドのタイトルにタグ付け(3/4追記)
英語のフォーラムでよく見かけますが、[2.x]や[CLOSED]のような「タグ」を付けると分かりやすいと思います。特に最初に質問のためのスレッドを立てた方は、問題が解決したらスレッドタイトルに[CLOSED]や[SOLVED]、あるいは日本語で[解決]のようなタグ付けをすると後から見る人にとって親切ではないでしょうか。


* CahceFlyはCDN(Content Delivery Network)サービスで、これを使えばExt JSのライブラリファイルを自前のサーバーに置かなくても利用することが可能になります。例えば、ext-base.css、ext-all.css、ext-all.cssを利用するには:


<link rel="stylesheet" type="text/css" href="http://extjs.cachefly.net/ext-2.2.1/resources/css/ext-all.css" />
<script type="text/javascript" src="http://extjs.cachefly.net/ext-2.2.1/adapter/ext/ext-base.js"></script>
<script type="text/javascript" src="http://extjs.cachefly.net/ext-2.2.1/ext-all.js"> </script>


上記のように書くだけでです。