【バックエンド、サーバーサイドの方に質問です】Pythonモジュールの作り方について

内容不備の指摘があり、以下のページで再度修正版を投稿させていただきました。
お手数おかけ致しますが、もしよろしければリンク先にてご回答いただけましたら幸いです。

【バックエンド】外部へのモジュール作成依頼時、仕様の指定方法に悩んでいます Python
https://teratail.com/questions/215503

こちらの投稿は投稿の問題点の議論やご指摘へのご回答・修正などが進行中のため、
そのまま続行させていただけましたら幸いです。

Python3でバックエンド開発の際、例えばあなたが
「この部分のモジュール作っといて」
「すぐ使える感じで」
と外部またはチームの他メンバーに頼みたくなったとします。

あなたなら具体的にどんなモジュールが上がってくることを期待しますか？
逆に上がってきてイヤなモジュールの例、
常識的なことも含めて、それぞれのご環境の思い思いのご回答で構いませんので教えて下さい。

（例）
・使われることを想定して各関数またはメソッドにDocが揃ってる。形式は〜の形式がいい。

・〜なときはsetup.pyも用意してほしい。〜な感じで使いたいことがある。

・モジュールファイルだけでなく、〜も用意しといて欲しい。

・クラスで作るか非クラスで作るかはこっちで指定したい。あとの中身は任せる。そのように作ってあったらいい。

・〜と頼んだのに上がってきたのは〜でイラッとした。

・〜と頼んだが意図を汲み取って〜までしてくれてて助かった。

不明点等ありましたらお聞かせください。可能な限りご回答して参ります。

宜しくお願いいたします。

reraNine

2019/10/04 05:00

低評価の指摘通り、質問内容が漠然としすぎているのかなと思います。ひとまず、質問者様が外部にモジュールを依頼する際に望みたい事を記載して下さい。例） ①○○は××が望ましい ②××が△△は原則としてNGとする等その中でここに疑問がある。この方法だとイマイチなのでプラスαで何か記載したいがどう記載すれば良いのかわからない等を書き込むと良いのではないかと思います。後はこういったケースの質問はベストアンサーの基準が付けにくいのであらかじめ記載すると良いと思います(投稿が一番早い。1週間以内の回答で個人的に一番納得する答えだった等)。

退会済みユーザー

2019/10/05 03:25

勉強不足で申し訳ありません…。確かにそうですね。ありがとうございます！早速修正してまいります。

退会済みユーザー

2019/10/05 04:52

以下のように修正させていただきました。問題点の解消について特に注意を行い再度執筆しました。逆に分量が多くなってしまい読みづらい点などありましたら修正して参ります・・・。お手数おかけ致しますが、もしご納得いただけましたらご回答いただけましたら幸いです。バックエンド】外部へのモジュール作成依頼時、仕様の指定方法に悩んでいます Python https://teratail.com/questions/215503