2016-11-29 09:43:59 +0000 2016-11-29 09:43:59 +0000
249
249

開発者としてドキュメントを使うとプロ意識が低いように見えてしまうのでしょうか?

私はジュニア開発者で、企業研究の一環としてソフトウェア開発会社で3ヶ月おきに働いているのですが、1年近くプログラミングをしているにも関わらず(3ヶ月×3ヶ月の実務経験+サイドプロジェクト)、仕事中にドキュメントやStack Overflowをチェックしなければならないことが多々あります。これは私がプロではないように見えたり、実際の私よりも経験が浅いように見えてしまうのを恐れています(私はソフトウェアの設計や構築には慣れていますが、"XYZを行うPHP/JavaScript関数 “のような用語を検索しなければならないことが多いです)。この質問をする理由は、Stack Overflowやドキュメントを頻繁に使うことで、他の人や自分の能力を疑ってしまうからです。私にとっては、より効率的に仕事をするための自然な部分であり、言語を意識するようになるための自然な部分です。以前、ある人がこんなことを言っていました。"外科医は患者を手術するたびに本を読むことはできない” というようなことを言っていました。私の意見ではナンセンスです。

私はまた、将来のためにお願いしています。

回答 (14)

125
125
125
2016-11-29 13:26:09 +0000

開発者としてドキュメントを使うとプロ意識が低いように見えますか?

**いいえ、実際にはその逆です… インターネットやドキュメントで簡単に見つけられるような質問をすることで、先輩方の邪魔にならないようにしています。私たち開発者は何千行ものドキュメントを覚えていることはありません… いつも、specially when we switch between technologies_

私はまた、将来のために尋ねています; 例えば、私は別の仕事のために面接中にコードを書かなければならない場合、私はあなたがドキュメントを使用するべきではないと思います。

ほとんどの合理的な企業は、コーディングテストで出てくるロジック/構造をテストしたいと思います… 構文についてはそれほどではありません。

63
63
63
2016-11-29 18:43:48 +0000

誰かがかつて私に言ったことがあります。"外科医は、彼は患者に手術をしなければならないたびに彼の本を読むことはできません。"

誰がそれを言った人は、手術がどのように動作するかを知っていません。それは外科医が百回練習している非常に一般的な手順でない限り、良いものは、彼らが参照してくださいすべての患者の前に勉強の多くの時間を費やしています。彼らはまた、数千年の間にあまり変更されていない主題を勉強する医学部で何年も費やしています。

あなたは物事を行うための新しい方法を毎週発明されている業界での最初の年にあります。経験が浅いので、頻繁に調べなければならないことが予想されます。自分が見つけた解決策が実際に自分の問題を解決しているかどうかを知るための基礎があり、その経験から学ぶことができる限り、何も問題はありません。私はソフトウェアエンジニアになって15年になりますが、今でもほぼ毎日調べる必要があります。プロは、仕事を完了させるために利用可能なあらゆるリソースを使用します。

29
29
29
2016-11-29 12:57:01 +0000

プロフェッショナリズムと知識は全く違うものです。

第三者の情報源から物事を調べるということは、知識が不足しているということであって、プロフェッショナリズムが不足しているということではありません。知識の欠如はそれ自体がテーマですが、全体的にすべてを知っている人はいません。

もしあなたが自分の知識の欠如を知っていて、第三者の情報源から物事を調べることで対処しているのであれば、それはあなたが知識の欠如という具体的な問題を解決するためのプロとしての戦略を持っていることを意味します。

そのようなことを知らないのに物事を調べないのはプロではありませんが、あなたの場合はそうではありません。

あなたの「文書を使う戦略」と対照的な効果についてさらに読み進めます。ダニング・クルーガー効果 ](https://en.wikipedia.org/wiki/Dunning%E2%80%93Kruger_effect)

24
24
24
2016-11-29 14:39:01 +0000

ドキュメントを開発者として使うとプロ意識が低いように見えるのでしょうか?

いいえ。PHP(一貫性の面では少し欠けています)でも、Web開発全般でも、いくつかの言語と十数個のフレームワークに精通していれば、それらの多くを覚えなければならないでしょう。

SO/Documentationを頻繁に使用しているためにあざ笑われてしまい、自分の能力を疑ってしまいます。同僚は使っていますか?なぜなら、そういった細かいことを調べるのはIDEのオートコンプリート機能に任せることができるからです。オートコンプリートを使用すると、ブラウザに注意を切り替えてそこで答えを検索するよりも効率的です。

同僚がIDEのオートコンプリートを使用していて、代わりにGoogleを使用している場合、それは非専門家に見える可能性があります - あなたがドキュメントを参照しているからではなく、非効率的にそれを行っているからです。

あなたの同僚が自分の記憶に依存していて、あなたがオートコンプリートに依存している場合、あなたはあなたのどれもがよく知られていないいくつかのフレームワークを使用してタスクでそれらをoupterformすることができるでしょう、それはウェブではそれほど珍しいことではありません。

19
19
19
2016-11-29 16:41:49 +0000

他の人はしっかりとした答えを提供していますが、誰もこれに正面から取り組んでいません; 太字の強調は私のものです:

この質問をする理由は、I get mocked for using Stack Overflow/documentation frequently which makes others doubt my abilities.

誰がこれらの人々はあなたを “あざ笑う "とどのようにそれを知っているのですか?もしあなたがジュニア開発者であれば、当然のことながら、他の人があなたをテストしたりボタンを押したりするようなヒエラルキーの中にいることになります。これは、彼らが意識しているかどうかに関わらず起こります。弁護士や医者は常に参考にしている本をたくさん持っているのではないでしょうか?プログラミングも同じです。

プログラマーとしてのあなたの仕事は、プロジェクトの欲望とコード自体の現実を橋渡しすることです。あなたの仕事は無意味なことを暗記することではありません。しかし、それは一夜にして起こることではなく、時には何人かにとっては全く起こらないこともあります。それは1つに成長するスキルであり、誰かが持っていることを要求することはできません。

16
16
16
2016-11-29 16:00:03 +0000

これはプロの人にはプロ意識がないように見えるかもしれませんが (大抵の場合)、素朴な顧客やマネージャーの前では注意した方がいいかもしれません。プログラミングの経験が1年近くあるあなたが、プロが物事を調べる必要があるかどうかわからないのと同じように、関連性の低い経験を持つ人々もまた、わからないかもしれません。

実際、私は何度か他の開発者を擁護したことがあります。

14
14
14
2016-11-29 16:08:10 +0000

しかし、その知識を保持していないまま、同じことを調べ続けているのであれば、問題があるかもしれません。それは非効率です。それはあなたを遅くさせ、それがあざ笑う原因になるかもしれません。毎回調べる必要がない程度に、自分の職業の基本を学ぶ必要があります。

10
10
10
2016-11-29 20:10:41 +0000

推測して間違ったコードを書くよりも、ドキュメントを読んで正しいコードを書く方がはるかにプロフェッショナ ルです。これは特に PHP のような言語に当てはまります。標準ライブラリは行き当たりばったりに設計されていて、覚えるのが大変で、 落とし穴だらけです。

mail() にはメールヘッダインジェクション保護機能がありません。

additional_headersにはメールヘッダインジェクション保護機能がありませんので、ユーザは指定したヘッダが安全であることを確認し、ヘッダのみを含むようにしなければなりません。これは additional_headers パラメータで設定することもできますし、デフォルトを php.ini で設定することもできます。

つまり、アプリケーションの動作はグローバルな設定に依存する可能性があるということです。

  • $to パラメータは RFC 2822 に準拠していなければなりません。

確かに、ドキュメントを注意深く読まなくても、より多くのコードを作成できるかもしれませんが、それはおそらく professionalquality のコードではないでしょう。言語やライブラリを正しく使用しているかどうかを確認するために、頻繁にドキュメントをチェックすることは恥ずかしいことではありません。

7
7
7
2016-11-29 10:20:30 +0000

わからないことを調べることで、時間の節約にもなりますし、より良い方法がないかどうかを調べることもできます。ネットで調べるだけで、もっと良い方法があるのに、同じことを何度も何度も繰り返してしまうのは、効率が悪いですよね。

4
4
4
2016-11-30 09:21:58 +0000

プロ」と「知識がある」の違いがあります。もし私が知りたい情報があって、椅子に座って動けなくなるか、書類を確認するかの選択を迫られたら、私は書類を確認します。

もしその情報が私の立場で知識のある人が知っておくべきことであれば、それを調べても私は知識がないことがわかるかもしれませんが、それでも完全にプロです。昨日は知らなかったことを、毎日何か新鮮なことがあるので、知っておくべきことをすべて知っていると仮定するのは愚かなことです。何かを know していたとしても、その知識が可能な限り最高のものであることをどのようにして知ることができるでしょうか?あなたは、同じテーマについて他にもっと良い知識がないかどうかを調べるためにドキュメントを参照します。しかし、それには時間がかかります。自分で解決するのに1時間かかるか、グーグルを使って5分かかるかの選択を考えると、その時間を使うのはプロではありません。

4
4
4
2016-11-29 22:24:12 +0000

他の方が回答されているように、ドキュメントをチェックすることがプロではないということはありません。そのため、彼は問題の解決方法についてウェブ上で調べていることがあります。前回は、例えば、あるWebフレームワークがどのようにバリデータやエラーカウンタを設計しているのかを調べてみたのですが、一見似たような機能を設計しているように見えたので、それを調べてみました。

これは、探しているものがあまりにも抽象的すぎて、インターネットではどうしようもない場合です。さらに悪いことに、一見合っているように見えるソリューションを見つけることができますが、実際にはそうではなく、異なるユースケースに適用されているためです。私はほとんどがコア言語の機能を使うコードを書いているので、ドキュメントはあまり見ません。しかし、私は些細なことで行き詰ったときはいつもdocを使っています。しかし、より高いレベルのことで行き詰ったときは、より経験豊富な同僚に助けを求めるのが良いでしょう。

2
2
2
2016-12-02 12:29:29 +0000

あなたはすでにいくつかの良い答えを持っていますが、少しひねりを加えてみましょう…

私はドキュメントを使っている人が好きで、それはあなたのプロ意識のための素晴らしいサインです。

Not using documentation

私は十分なプログラマーを知っていますが、長い時間の間、本当の計画を立てずにつまずくことを知っています。率直に言って、私はこの種のアプローチが大嫌いです。彼らは決して遠くに行くことはなく、多くの場合、人に尋ねなければならず、アドバイスをほとんど受けず、永遠にこのように続けることを好むようです。

チュートリアルだけ?

人々は頻繁にチュートリアルやSOを含むコードスニペットをググって、out ever referring to documentationを参照せずに、私は最後まで私を怒らせます。私の考えでは、この行動は大きな罠だと思います。これは、中途半端で、恣意的で、体系的でない「知識」を燃料とした一種のプログラミングにつながります。そのようなプログラマーは、多くの偏見を持ってしまう傾向があります。これは、「007は絶対に使ってはいけない」「SQLで007は絶対に使ってはいけない」「XXXは必ずやる」「YYYは絶対にやってはいけない」というようなナゲットがあるところから来ている。彼らは、既成概念にとらわれずに考え、新しいアイデアを考え出し、アプリケーションをどのように構成するかについての直観を形成し、偉大な開発者を構成するすべてのものを形成することが非常に困難であることに気づくでしょう。あなたの問題が明らかにバグのようなものであったり、ドキュメントのどのような並べ替えでも扱われそうにないような、非常に、非常に、非常に、非常に特殊なものである場合 (例えば。

もしそれがドキュメンテーション/APIによって簡単に見つけ出すことができるものであれば、私は座ってプログラミング言語/ライブラリなどの特定の部分に取り組むことをお勧めします。これはほとんどの場合、API リファレンスなどの古き良きドキュメントを読むことで達成されます(これも私の経験上、私が接した多くのプログラミング言語で)。

例えば、古い C++ の古典 (古き良き紙)、Gang of Four Design Patterns、(オンライン版の) “Programming Ruby” マニュアル、非常によくできた Perl のマニュアル、Git book、特定の RFC、HTML/XML/その他の仕様書などを前から後ろまで読むことは、私には無茶だとは思えません。私は、暇な時にでもそれをやっていますし、やったことがありますし、率直に言って、それなりの価値のあるプログラマーに期待しています (明らかに、彼らが何を扱っているかによりますが)。また、私は(少なくとも過去数十年の間に私が働いていた会社では)一人でこの意見を持っていることを十分に認識しています。

(注: 明らかにAPI参照の膨大なリストを暗記する必要はありませんが、少なくとも、何が利用可能で、APIの “精神 "が何であるかを確認するために、それらのリストに目を通す必要があります。 )

トピックを徹底的に快適にした後、thenは、インスピレーションのためにサードパーティのコードを見たり、古いSOの質問を見たり(または自分で新しい質問をしたり)する時間です。

また、あなたがこのような1つの分野を吸収したとき、あなたのドキュメントを取得する場所(マニュアルページなど)の肉に右にズームインすることによって、答えを見つけることが非常に簡単になることを見つけるかもしれません。この時点では、エディタのオートコンプリートで十分かもしれません。そして、あなたが作業しているツールでは不可能なことがすぐにわかるので、無駄な検索の手間を省くことができます。

0
0
0
2016-12-05 01:57:48 +0000

プログラマーとしてのスキルは、どれだけ多くのAPIを覚えられるかではなく、いかに全体像を把握し、効果的なソリューションを設計できるかにかかっています。目標は、仕事を正しく効率的にこなすことです。もしあなたがすべてのAPIを調べて、すべての詳細を調べなければならなかったとしたら、私はあなたには問題があると言うでしょう。良い開発者には、頻繁に使われるもの、最近使われたもの、日常的に使われるものすべてに精通していることを期待しますが、簡単に調べられるのに、あまり使われないものに脳力を浪費しないことを期待します。もしあなたが一日に一回程度の頻度で stackoverflow を訪問しているのであれば問題ありませんが、もしあなたが典型的な仕事の日のほとんどを stackoverflow を利用しているのであれば、それは問題になるでしょう。

-1
-1
-1
2016-12-06 14:36:27 +0000

他の人の意見はあなたを定義しているのではなく、themを定義しているだけです

開発者としてドキュメントを使うとプロ意識が低いように見えますか?

「外科医は、彼が患者に手術をしなければならないたびに彼の本を読むことはできません」

なぜですか?私は、異常な時間のクランチがない限り、その主張に懐疑的です。参考資料を使うのは数秒で済むことです。

他の仕事の面接でコードを書かなければならない場合……資料を使うべきではないと思いますが

面接のルールにもよりますが、許すところもあれば許さないところもあります。特にテストであれば許可される場合もあります。まずは確認してみるのが良いでしょう!

関連する質問

21
9
20
15
17