SUGARSPOT

Androidアプリ、WEBサービス開発の SUGARSPOT  |Androidブログ「Androidのことなんだけど」もやってます

2018年9月18日火曜日

システムの仕様書をMarkdownで書く

これまでも仕様書はテキストで箇条書きしていたんですが、ドキュメントのベースがExcelでした
Excelを方眼用紙にして箇条書きしてたんですよね
方眼用紙にしてたのは

  • 画像を埋め込む時に位置が決めやすい
  • 段落をつけやすい
  • 色分けしやすい(背景とか一部に色付けしたりする)

これだけの理由でExcelを使っていたんですが、どうせ箇条書きにするならMarkdownで書けばいいじゃん。ということで今更ながらMarkdownで仕様書を書いています

(画像とか色付けとかは見やすくする為のものなので、Markdownの書き方でなんとかなります)

Wikiとかでも良かったんですが、気軽に使える良さそうなのが見つけられませんでした。。

ツール

Editor: Visual Studio Code
Extensions:

  • Auto-Open Markdown Preview
  • Excel to Markdown table
  • Markdown All in One
  • Paste Image

なかでもPaste Imageが便利でいいですね
クリップボードにコピーした画像が簡単に保存できちゃうのが便利
「image/hoge」とか書いて、それを指定してペーストするとimageフォルダにhogeって名前で画像を保存してくれます
何も指定せずにペースとすると日時をファイル名にしてルートに画像が保存されます

便利!

テキストベースなのでGitで管理できるし、勿論差分もわかりやすいのでGood.
Markdownでの書き方(仕様書としての見やすさ)はまだまだ模索中なので、ベストな書き方が見つけられたら続報をブログに書きたいと思います

以上。

2018年9月3日月曜日

Foremaの事業に参加しました

9月よりForemaの事業に参加することとなりました
(https://www.fore-ma.com/)

Foremaとは

Forema(フォレマ)は日本最大(を目指す!)ジビエ食材のオンラインマーケットです。
Foremaで主に取り扱うのは日本国内で仕留められた野生の鹿と猪 (駆除・狩猟の双方)。ヒレやモモ、ロースといった一般的なお肉のほか、ソーセージやベーコンといった加工品、燻製や肉マンといった地域オリジナル商品など、全国のジビエ関連商品を多く取り扱っていく予定です。
また、鹿や猪だけでなく、ウチダザリガニやヨーロッパナマズといったいわゆる『侵略的外来種』に関する商品の開拓や、鹿の角や皮、猪の毛皮や牙といった、これまで廃棄物として捨てられていたものを可能な限り再利用できるよう商品開発も行っていきます。
(Foremaホームページより引用)

と、いうふうにジビエを販売しております
その中で、ペット向けの定期販売のサービスを拡充していくということで、このたび参加することとなりました

ペットさん定期便」(https://teiki.fore-ma.com/)

ペットを買ってらっしゃる方は、ぜひ「ペットさん定期便」をチェックしてみてください

また、Foremaに参加していますが、変わらずSUGARSPOTとして個人事業を続けております
SUGARSPOTとしてもAndroidアプリの開発やWebシステム開発など承っておりますので、ぜひ声をかけてください