New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

全体とりまとめ用プルリクエスト #13

Merged
merged 140 commits into from Jan 21, 2014

Conversation

Projects
None yet
4 participants
@mizzy
Copy link
Owner

mizzy commented Jan 14, 2014

全体を見渡しながら、各章の整合性を合わせるためにファイルを統合しました。

今までのプルリクで助言いただいたもので、まだ反映できてないものがありますので、それらも反映しつつ、全体をまとめていきます。

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 14, 2014

ひとまず、1章、2章の見直しを行いました。明日はまだ中途半端な状態の3章を重点的にやります。

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 15, 2014

まだ全体を通しで読んでいませんが、1章をざっと眺めて、内容以外で気付いてた点で以降の章でも実践して頂きたい事として、

  • ()での説明はあまり論文では見かけないので、()無しでうまく文章を構成した方が良い気がします
  • [1][2]などまとめて参照しておいて、その後で個別に説明が入る場合は、個別にも[]をつけておいた方が親切だと思います
  • 意識的に文章を短くして頂いていますが、そのせいか文章間で接続詞を入れた方が読みやすい所があるように思います
  • 微妙な所ですが「シェルスクリプト」等固有な意味が強い単語はできるだけそれが表す意味に置き換えるか、あるいは定義するか、どうしても使う必要があれば何か文献を参照しておいた方が良いかもしれません。そうしないと、筆者の頭の中に色々と暗黙の前提条件があるように見えてしまい、読者がマイナスの評価を与える可能性があります。
  • 段落の切り方に注意して下さい(1p 右カラム 4、5行目は繋げる、p2左カラム1、2行目もつなげる)

上記の点について、その他当てはまりそうな箇所で意識しつつ執筆してみて下さい。内容や全体の流れは引き続き見ていきます。

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 15, 2014

  • 「テスト駆動開発」は参照文献が必要です
  • 「\Infrastructure as Code" という概念が台頭し,\Agile infrastructure and operations"[5] という流れが生まれている.」

この文ですが、概念が台頭した事と、流れが生まれた事は因果関係があるように読めますが、その内容がかかれていません。そこを明確にすると分かりやすいです。

  • 「この流れの中で,\Agile infrastructures」

ここは段落を切りたいので、この流れの中で、は不要です。

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 15, 2014

了解です!

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 15, 2014

  • 基本的に図表を書く場合は、「図1に~を示す」と書きます。
  • 表のタイトルは表の上、図のタイトルは図の下になります。
  • 3章か4章に、汎用性や記述の書きやすさをアピールするために、サンプルや従来手法の記述との比較をページが許す限り図で提示すると良いと思います。
@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 15, 2014

こちらも了解です!ありがとうございます!

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 15, 2014

「シェルスクリプト」は「UNIXシェルにより書かれたプログラム」だとどうでしょうか?
「UNIXシェル」という言葉自体は、情報処理学会論文誌掲載のPrologへのラムダ項の導入とマクロとしての展開でも使われていました。

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 17, 2014

2.1ですが、全体の流れからこの節で、独自のドメイン固有言語での記述と、実装言語と同じ言語を利用したドメイン固有言語での記述の違いをもう少し詳しく書いた方が良いように思いました。ここは、最終serverspecの議論の箇所になるところ(書きやすさや汎用性)だと思うので、誤読しないように詳しめに強調して書いた方が良いように思います。

例えば、「なぜ開発者に強く訴求するのか」を書くと十分だと思います。

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 17, 2014

と思ったら2.2で書いているのですね。ということは、2.2の内容を2.1に少し移動したら良いと思います。

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 21, 2014

あ、2.4、3.1、3.2ですね。

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 21, 2014

2.4, 3.1, 3.2 了解しました!

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 21, 2014

エラーなく提出できるかどうか確認するために、いったん提出してみました。問題なさそうです。
締切まで差し替え可能とのことなので、更にブラッシュアップしていきます!

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 21, 2014

所属の所ですが、「現在」や「Presently with」、「情報科学科通信教育課程」は抜いてしまって、最初のページに所属情報をまとめる事はできそうですか?

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 21, 2014

「現在」や「Presently with」は配布されているTeXのスタイルファイルが勝手に入れてるものなのですが、スタイルファイルいじってみます!

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 21, 2014

最初のページにまとめてみました!

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 21, 2014

はい、OKです。今回の研究会としては、もう内容や構成は十分だと思いますので、最終チェックして読者が読みにくいだろうと感じる所、特に構成管理ツールの前提知識とそれによって記述されるコードをテストする事に対して理解が低い人、でも理解できるように修正してみて下さい。また、図表の位置はできれば、上部にまとめるのが見やすくて良いです。

そこが大体ブラッシュアップできれば、提出して頂いて結構です!

この分野ではじめて書く論文にしては、非常に良い論文になったと思います。長い間お疲れ様でした!

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 21, 2014

了解しました!図表の位置はTeXが勝手にレイアウトしてくれちゃうので、あまり自由にできないのですが、調整してみます!

ご指導ありがとうございました!今後ともよろしくお願いいたします。

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 21, 2014

電車等の関係もあるので、23時になったら完了して提出したいと思います。

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 21, 2014

👍

@mizzy

This comment has been minimized.

Copy link
Owner

mizzy commented Jan 21, 2014

最終提出を行い、「講演原稿pdfファイル受理のお知らせ」メールが届いたことを確認しました。

長時間お付き合いいただき、また、福岡後滞在中にも関わらず最終チェックしていただき、本当にありがとうございました!

また次に繋げていきたいので、引き続きご指導よろしくお願いいたします! 🍣

mizzy added a commit that referenced this pull request Jan 21, 2014

Merge pull request #13 from mizzy/all
全体とりまとめ用プルリクエスト

@mizzy mizzy merged commit 17da8a6 into master Jan 21, 2014

@mizzy mizzy deleted the all branch Jan 21, 2014

@matsumotory

This comment has been minimized.

Copy link
Collaborator

matsumotory commented Jan 21, 2014

本当にお疲れ様でしたー!!!とても良い論文になっていると思います!!!! 🍣

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment