マニュアル執筆中(その29)

とりあえずマニュアルの誤字等の修正とチュートリアルの追加等を行いました。
これで少しはわかりやすくなったと思います。

ちなみに現時点でのプロジェクトページへのアクセス数は0回です。
数日前に50回以上アクセスがあったのが嘘のような失速です。
コメントが全くないので自分がどういう評価なのかわかりませんが、多分そういう評価なのでしょう。

RTMのfacebookでCalc、ExcelのRTCが面白いとか書かれていて「何か賞をもらえるかも」と思ってRTMコンテストに参加したという経緯があります。
人を煽てておいて放置するのはまずいのではないですか？なんでだよ

というわけで1.1.1のリリースに向けての作業で忙しいとは思いますが、産総研のRTM関連の人はぜひプロジェクトページにコメントしてください。

すみません、自分で勘違いしただけなのにちょっと調子のいいことを書きすぎました。コメントは気が向いたら書いてください。もちろん他の人も暇であれば書いてください。





それにしても、他の参加者で一体どんな作品を投稿するのでしょうか？
「一番面白いものを作る」とか「優勝を狙う」とか書いてあるのは見ましたけど、全く実体が見えないので不気味です。参考になりそうなアイデアなり技術があればぜひともパクりたいので作品投稿を楽しみにしています。

個人的な意見なので聞き流してもらって構いませんが、他の参加者にはできれば以下の作業をしてほしいと思っています。かなり勝手な意見なので不快に思われた方は無視してください。

1. 動作確認までが簡潔に書かれたマニュアルの作成
2. ソースコード、マニュアルの入手先を明確に書くこと
3. インストーラーの作成

まず1ですが、ちょっとでいいから使ってみたいという個人的な理由からこんなことを書いてます。マニュアルを読んだだけではよくわからないかもしれないので、とりあえず動作させてみたいです。
次に2ですが、これがわからなければ使う側も困惑するのでプロジェクトページには最悪これだけでいいので書いてほしいです。
最後に3はこれが一番の無茶振りなのは理解しているのですが、ユーザーにCMake→ビルドの作業を強いるのはさすがに辛いです。
極端な話ですがOpenRTM-aist-1.1.0にインストーラーがなくて「ソースからビルドしてね(・ω<)」とか言われたらさすがにやりたくないです。何年か前のOpenHRP3なんてまさにその状態でインストールで大苦戦しました。

WixでWindowsインストーラーは意外に簡単に作れるのでご検討をよろしくお願いします。Linuxは・・・・どうしましょうね？Debパッケージなんて作ったことないのですけど、どの程度の手間がかかるのでしょうか？

にほんブログ村のロボットのカテゴリから
全然人が来ない・・・

マニュアル執筆中(その28)

今日はSI2014の予稿原稿の締め切りです。
なので、おそらく来週から続々と作品投稿されることになると思います。
正直なところ1人ぐらい先走る人がいるかと思ったのですが皆さん慎重ですね。

そういえば、さっき予稿原稿の締め切りを知らせるメールが来ました。
その中で9月30日までにRTミドルウェアコンテストサイトへの参加登録(ログインしているとこのページの下のフォームからできる登録です)もしてくださいということも書いてあってので、僕以外にも勘違いした人がいたみたいです。ちょっと安心しました。なんでだよ


マニュアルにApache OpenOffice 4.1.1でのインストール方法を追記しました。
ただし、OpenRTM-aist-Pythonのインストールに手間がかかるため推奨しません。


それからUbuntu-14.04LTSでLibreOfficeの対応しているPythonのバージョンを調べたところ3.4だったので使用できないことがわかりました。
一応LibreOfficeの対応しているPythonのバージョンを変更する方法もあるとかないとからしいのですが、こちらで実験するだけならともかくダウンロード先でそれを強いるのはさすがに無理があるのでLibreOiffce4.0以降がインストールされているUbuntu13.04～14.04のサポートはしないことにします。
OpenRTM-aist-PythonがPython3に対応するのを待つしかないようです。




今日もコメントなし。
どうにもRTMのメーリングリストとか見てると「ググレカス」とか「普通に考えればわかるだろ」とか言う人は全くと言っていいほどいません。前に一人だけ見たことがあるぐらいです。
それは凄く良いことなのですが、どうもそのことがコメントが全く付かない原因になっているような気がします。僕は苦情でも悪口でもとにかく質を問わずコメントが欲しいのですが、そんなこと書く人がそもそもいないみたいです。ちなみに僕は人の非難をすることが目的になっているような人間は大嫌いです。他の候補者の批判ばかりしている政治家は信用できません。それにもかかわらず苦情や悪口でも欲しいというのは相当卑屈になっているからです。

とりあえずコメントにこだわるのはやめて、プロジェクトページ上部のいいねボタンが20回以上押されることを目標にしようかな。



これからはマニュアルに力をいれます。
RTMコンテスト2010のRTC-scilabのマニュアルがコメント欄で良く書けてるとか評価されてたのでとりあえずこれを熟読してみた。
何というかマニュアルの質も良いのですが、ソフトウェア自体が段違いのクオリティだなあ。
このレベルの作品を今年出されたら100％勝ち目がありません。現に当時も全く手も足も出なかったので。




マニュアルの全体の流れとして、

1. 概要
2. インストールの方法
3. 使う前の準備(ネームサービスの起動等)
4. 動作確認
5. 簡単なデモ
6. 高度なデモ
7. トラブルシューティング

やっぱりマニュアルはこのぐらいの長さでないと読む気が起きません。
というよりどのソフトウェアでもはマニュアルを読まなくても使用できるのが理想形なのであって、ちょっと試用したいだけなのに長いマニュアルを読まなくてはいけないソフトウェアはなかなか評価しづらいです。




このマニュアルと比較して自分のマニュアルは何が足りないかを考えてみます。
チュートリアルが動作確認を兼ねているつもりなのですが、ちょっと不親切かもしれません。
インストール後チュートリアルに誘導するように加筆しておきます。
それからチュートリアルで簡単な動作しかしていないことが前々から問題だと思っていました。もっと具体的なシステムの例があれば用途がわかりやすいのですが、なかなかアイデアがありません。
トラブルシューティングもとりあえず書いておきます。









にほんブログ村のロボットのカテゴリから
全然人が来ない・・・

マニュアル執筆中(その27)

OpenRTM-aist-1.1.1がリリースされたら現在配布しているExcelRTC、WordRTCの内容を大きく変更しようと思います。

• OpenRTM-aist-1.1.1-Releaseへの対応
• ExcelControl.dll、WordControl.dllをインストーラーに追加
• バグ改善

下2つは別に1.1.1のリリースとは関係ないのですが、前からやろうと思っていたので変更します。

あとExcelRTCで既存のファイルを開いてデータポートを自動的に追加する際に接続したいデータポートがない場合にバグが発生する可能性があるのでちょっと修正しました。今配布しているバージョンではこのバグがあります。







いろいろ調べていて気付いたのですが、このページを見る限り1.1.1-Releaseを使用するためにはPython2.7をインストールする必要があるらしいです。
Python2.7がインストールされた状態でOpenRTM-aist-Python-1.1.0-RC1のインストーラーを使ったところ、少なくともこちらの環境ではOpenRTM-aist-Pythonをインストールできませんでした。となるとこちらの方法でインストールすることになりますがかなりしんどいですね。
Python2.7でOpenRTM-aist-Pythonを使っている人なんてあまりいないでしょうし、先ほど1.1.1-Releaseに対応すると書きましたが前言撤回するかもしれません。














にほんブログ村のロボットのカテゴリから
全然人が来ない・・・

マニュアル執筆中(その26)

昨日は50回ぐらいプロジェクトページにアクセスがあったのですがやはりコメントはなし。
やはりプロジェクトページやマニュアルがそれなりの出来でないと使ってもらえるところまで行きつかないようです。

いきなりこれだけの人が来たのは多分ツイッターでリツイートしてくれた人がいたからだと思うのでたいへんありがたいです。リンク先のリツイートの欄の人達をぜひフォローしてください。


あと誰かはわかりませんがプロジェクトページの上の方にあるいいねボタンを押してくれた人達にも感謝したいです。





そういえばまたミスをしてました。
ExcelRTCのAssemblyInfo.cppの内容を書き換えるのを忘れてました。

というか東芝製ノートPCを使っているからってAssemblyCompanyAttributeとかAssemblyCopyrightAttributeがToshibaになるのはやめてほしいです。
ユーザー名が入るとか空白とかじゃないのかよと。
勘違いされてたらどうしよう。まあこのプログラム見てそう勘違いする人はいないと思いますが。



別にソフトウェアの動作には関係ないですけど、今回のミスはかなりずさんだったので反省しています。




あとExcelRTC、WordRTCに謎の不具合があります。
PCを起動してから一度もExcel、Wordを起動していない状態(現在Excel、Wordが終了していても過去に起動していれば問題なし)でExcelRTC.exe、WordRTC.exeを実行すると起動できずに終了します。ただもう一度ExcelRTC.exe、WordRTC.exeを実行すると普通に起動できます。

よくわからないのはWindows Vistaではこの問題が起こるのですがWindows 8では同じ状況でも普通に起動できてしまうのが不思議です。Windows Vista上でビルドしたのに。

とりあえず一旦起動できなくても、もう一回ExcelRTC.exe、WordRTC.exeを実行すれば起動できるのでこういう問題の起こった人はそうしてください。







にほんブログ村のロボットのカテゴリから
全然人が来ない・・・

マニュアル執筆中(その25)

どうやらOpenRTM-aist-1.1.1-Releaseの公開が近いらしい。
そのページを見ると10月1日みたいに見えますね。

1.1.1が公開されたらExcelRTC、WordRTCを対応させたいとは思います。
それならいっその事Visual C++ 2013に乗り換えようかとも思ったのですが、まだ使っている人も少ないだろうしダウンロード先でビルド出来なければマイナス点になるかもしれないのでやめておきます。




未だにプロジェクトページにコメントはなし。
一体どうすれば良いのかわかりません。
とりあえず何かひらめくまで地道な作業をするしかないか。








にほんブログ村のロボットのカテゴリから
全然人が来ない・・・