আপনি কীভাবে কোড লেখকদের ট্র্যাক রাখেন? [বন্ধ]

Question

এটি এমন কিছু যা আমাকে কখনও শেখানো হয়নি। বিভিন্ন ধরণের রাইটিং স্টাইল আমি দেখেছি। আমি মূলত জাভা এবং পাইথনে কোড করি। আমি ভাবছিলাম যে কোনও মানক রাইটিং স্টাইল ছিল বা যদি সবকিছু ফ্রি স্টাইল হয়। এছাড়াও যদি আপনি উত্তর দেন তবে আপনি বাড়িতে বা কর্মক্ষেত্রে আপনার তৈরি করা ফাইলগুলির লেখকগুলিতে যে স্টাইলটি ব্যবহার করেন তাতে সংযুক্ত হতে পারে।

আমি সাধারণত যাই

@author garbagecollector
@company garbage inc.

Comments

যে ব্যক্তি আপনার কোড পরিবর্তন করে তাদের নাম কোথায় রাখবে?

— জেফো

@ জেফ এটি কোথায় এবং কীভাবে দেখায়।

— ডাস্টিপ্রোগ্রামার 15

এটি করার কোনও মানে হয় না। আপনি এটি কেন করতে চান?

— কোডার্ট

Answer 1

আপনি যা জিজ্ঞাসা করছেন তা সম্পূর্ণরূপে নিশ্চিত নয়, তবে আমি খুব কঠোর স্টাইল ব্যবহার করি:

;==========================================
; Title:  Author Style Sample
; Author: Darknite
; Date:   7 Jan 2011
;==========================================

শৈলী সমাবেশ প্রোগ্রামারদের দ্বারা অনুপ্রাণিত হয়।

আমি এটি লেখকের পৃষ্ঠাগুলির শীর্ষে রেখেছি, এটি কোনও শ্রেণি, পাঠ্য ফাইল, বা এসকিউএল সঞ্চিত প্রক্রিয়া ইত্যাদি যদি না হয় less

Comments

এটি আমি যা খুঁজছি তার লাইনের সাথে রয়েছে।

— ডাস্টিপ্রোগ্রামার

-1 এটি (যা আপডেট হলে অনেকগুলি বেড়ে যায় (এটি উভয় এবং বিভিন্ন লোকের কোড পরিবর্তন করে) কার্যকরভাবে সংস্করণ নিয়ন্ত্রণ দ্বারা প্রতিস্থাপন করা হয়

— মাইকেল ডুরান্ট

@ মিশেলডুরান্ট আপনি নিজের বন্ধনী বন্ধ করতে ভুলে গেছেন;) যাইহোক শীতল। আমি পেঙ্গুইন পছন্দ করি

— অন্ধকার রাত

@ জর্জিও সত্যই নয় ... ফাইলটিতে মূল লেখকের কোডের একটি লাইন নাও থাকতে পারে। ইহা অর্থহীন.

— উইলবার্ট

@ উইলবার্ট: অবশ্যই এটি দলের নীতিতেও নির্ভর করে: ভাগ করা কোডের মালিকানার সাথে কোনও ফাইলের লেখকের খোঁজ রাখা অর্থহীন হতে পারে। স্বতন্ত্র কোডের মালিকানার সাথে এটি জানা গুরুত্বপূর্ণ যে কোন ফাইলগুলির জন্য কে দায়ী।

— জর্জিও

Answer 2

তুমি কেন? এটি ভার্সন সিস্টেম এবং "দোষ" এর কাজ :)

Comments

সংস্করণ নিয়ন্ত্রণ ftw।

— পল নাথান

আপনি সংস্করণ নিয়ন্ত্রণ ব্যবস্থা (ভিসিএস) এর পরিবর্তে সোর্স কোড ম্যানেজমেন্ট (এসসিএম) হিসাবে মনে করেন এমনভাবে এটি আরও বেশি জ্ঞান অর্জন করে।

— পিটার আইসেন্ট্রাট

ছোট সীমাবদ্ধতা, প্রসাধনী পরিবর্তন (প্রবর্তন, ইত্যাদি ...) রেখার লেখককে পরিবর্তন করুন ...

— ম্যাথিউ এম।

@ ম্যাথিউঃ: ভাল এসসিএম দেখিয়ে দিতে পারে যে সময়ের সাথে সাথে কে কী পরিবর্তন করেছে, কেবল এটি স্পর্শ করার শেষটি নয়। আমি যুক্তিও দিতে পারি যে প্রসাধনী পরিবর্তনগুলিও পরিবর্তন হয়।

— গ্রসভোভেল

এই উত্তরটি 8 বছরেরও বেশি পুরানো, এবং এর বিধিনিষেধের বিষয়টি কেউ লক্ষ্য করেনি? এটি কেবলমাত্র তখন প্রয়োগ হয় যদি উত্স কোডটি তার পুরো জীবনের সময়কালে একটি ভিসিএসে থাকে (বা সঠিকভাবে স্থানান্তরিত হয়)! যাইহোক, প্রচুর ওপেন সোর্স কোড সময় সময় বিভিন্ন পরিবেশের মধ্যে স্থানান্তরিত হয়, তাই লেখক তথ্য যদি সরাসরি সোর্স কোডে না লেখা হয় তবে তা পাস করা যাবে না।

— ডক ব্রাউন

Answer 3

আমরা আমার সংস্থায় রাইটিং করি না। পরিবর্তে, আমরা আমাদের সংস্করণটিকে এটি নিয়ন্ত্রণ করতে পারি।

প্রতিবার আপনি চেক ইন করুন, এটি আপনার ব্যবহারকারীর নাম পরিবর্তন তালিকার সাথে সংযুক্ত করে। যদি কোনও কিছু ভাঙা যায়, কেউ ফিরে যেতে পারেন এবং পরিবর্তিত ইতিহাসটি দেখতে পারেন কী পরিবর্তন হয়েছে, কখন, এবং কে করেছে। সময়ের সাথে সাথে কোনও ফাইল কীভাবে বিকশিত হয়েছে, কে এটি স্পর্শ করেছে, কী প্রকল্পগুলি সেখান থেকে ব্রাঞ্চ করেছে তা দেখার জন্য এটি সংশোধন গ্রাফটিও ঝরঝরে দেখাচ্ছে।

কোনও ক্লাসে লেখকের ট্যাগ লাগানোর সাথে আমি যে সমস্যাটি দেখছি তা হ'ল সময়ের সাথে সাথে সম্ভবত একাধিক বিকাশকারী সেই শ্রেণিতে কাজ করবে। আপডেট, এবং মত। লেখকের মন্তব্য আপডেট করার জন্য এটি একটি অতিরিক্ত পদক্ষেপ এবং অতিরিক্ত ছোট পদক্ষেপগুলি অনেক কিছু ভুলে যায়। সুতরাং এটি দ্রুত পুরানো হয়ে যায়।

Answer 4

আমি মোটেও তা করি না। আমি মনে করি কর্মক্ষেত্রে আমাদের কিছু টেমপ্লেট রয়েছে যা ফাইলের সর্বশেষ সংশোধনকারী ব্যক্তির কোম্পানির নাম এবং ব্যবহারকারীর নাম সহ ফাইলগুলিতে getsোকানো হয়, তবে আমি কখনই সেদিকে মনোযোগ দিই না।

সাধারণভাবে, আমি মনে করি না আপনি এটি কীভাবে করেন তা সত্যই গুরুত্বপূর্ণ। আপনি যদি নিজের ফাইলগুলি লেখক-স্ট্যাম্প করতে চান তবে কেবল একটি সামঞ্জস্যপূর্ণ শৈলী চয়ন করুন এবং এটি দিয়ে যান।

Answer 5

জাভাডোক জাভা সম্প্রদায়ের মধ্যে খুব মানক:

http://download.oracle.com/javase/1.3/docs/tooldocs/win32/javadoc.html#@author

@author নাম-পাঠ্য

যখন-অনুমোদিত বিকল্পটি ব্যবহৃত হয় তখন উত্পন্ন নথিগুলিতে নির্দিষ্ট নাম-পাঠ্যের সাথে একটি "লেখক" এন্ট্রি যুক্ত করে । একটি ডক মন্তব্যে একাধিক @authorট্যাগ থাকতে পারে । আপনি প্রতিটি @authorট্যাগ প্রতি এক নাম বা প্রতি ট্যাগ একাধিক নাম নির্দিষ্ট করতে পারেন । পূর্বের ক্ষেত্রে জাভাডোক একটি কমা (,) এবং নামের মধ্যে স্থান সন্নিবেশ করায়। পরবর্তী ক্ষেত্রে পুরো পাঠটি পার্স করা ছাড়াই উত্পন্ন নথিতে অনুলিপি করা হয়। অতএব, আপনি যদি কমা ব্যতীত কোনও স্থানীয় নাম বিভাজক চান তবে প্রতি লাইনে একাধিক নাম ব্যবহার করুন।

Answer 6

আমি মনে করি এটি সংস্করণ নিয়ন্ত্রণ ব্যবস্থায় সবচেয়ে ভাল।

Answer 7

আমি জিআইটিতে দোষের বৈশিষ্ট্যটি পছন্দ করি । আপনি দেখতে পাচ্ছেন কে প্রতিটি টুকরা / কোডের লাইনটি রচনা করেছেন। শুধু একটি ফাইল নয়।

Comments

অন্যান্য ভিসিএসগুলির একই জিনিস রয়েছে (যদিও প্রায়শই "দোষ" বলা হয় না)।

— রিচার্ড

আমি এটি -1 করব কারণ এটি জিআইটি নির্দিষ্ট। ওপি কখনও জিআইটির কথা উল্লেখ করেনি। কিন্তু হায়রে, ডাউনটাতে আমার কাছে পর্যাপ্ত প্রতিনিধি নেই।

— টমাস এডিং

Answer 8

আপনি যদি অনেক অবদানকারীদের নিয়ে একটি বৃহত প্রকল্পে কাজ করে থাকেন তবে প্রতিটি ফাইলকে লেখকের তালিকার সাথে টিকিয়ে দেওয়া ঠিক কাজ করে না। আপনি যখন কোনও ফাইলকে কয়েকটি ছোট ফাইলগুলিতে বিভক্ত করেন তখন লেখকের তালিকার সাথে আপনি কী করবেন? আপনি যদি কোডটি পুরোপুরি নতুন করে লিখেন তবে আপনি কি মূল লেখকের নাম রাখেন? আপনি যখন মন্তব্যে কোনও টাইপ ঠিক করেন তখন কি আপনি লেখকের তালিকায় আপনার নাম যুক্ত করেন?

এই প্রশ্নগুলি সংস্করণ নিয়ন্ত্রণ ব্যবস্থার জন্য আরও ভাল।

তবে আমি লেখকদের তালিকার সম্পূর্ণ বিরোধী নই। পুরো প্রকল্পের জন্য লেখকদের একটি তালিকা রাখা নিখুঁত ধারণা তৈরি করে। যদি এটি একটি একক-ফাইল-প্রকল্প হয়, অবশ্যই, এটি খুব ফাইলের মধ্যে রাখুন। যদি এটির বৃহত্তর প্রকল্প হয় তবে এটিকে README বা আপনার শীর্ষ স্তরের উত্স ফাইল (ওরফে মেন। তবে প্রতিটি একক ফাইলে লেখক তালিকাভুক্ত করে নিজেকে পুনরাবৃত্তি করবেন না।

Answer 9

আমরা সংস্করণ নিয়ন্ত্রণ সিস্টেমটি ব্যবহার করে বা @authorকোডে রেখে ট্র্যাক রাখি । এটি করার আরেকটি উপায় হল আরও সাধারণভাবে বলা, নির্দিষ্ট লোকেরা পুরো মডিউল বা পুরো প্রোগ্রামের লেখক were এটি লোকেদের মেশিনে একটি কগ হিসাবে পরিবর্তে একটি দলের অংশ হিসাবে নিজেকে ভাবতে উত্সাহিত করে যা ঠিক এক্স সংখ্যার কার্যকারিতা বা কোডের লাইনগুলির জন্য দায়ী।

Answer 10

আমি ব্যবহার Doxygen শৈলী (অথবা কখনো কখনো KernelDoc) প্রায় কাছাকাছি সব কিছুর জন্য মন্তব্য নেই। আমি বেশিরভাগ সি এবং পিএইচপিতে কাজ করি যেখানে ডক্সিজেন বেশ জনপ্রিয়।

বেশিরভাগ ক্ষেত্রে, নিম্নলিখিত তথ্য অন্তত অন্তর্ভুক্ত করা সহায়ক:

• এটি অনুলিপি করার অনুমতি (বা না) সংস্থা বা স্বতন্ত্রের কপিরাইট
• লেখকের নাম / ই-মেইল
• তারিখ লিখিত
• সর্বশেষ পরিবর্তন তারিখ

এটি ফাইলের কাজ করে এমন যে কোনও ব্যক্তিকে তাদের কী সাহায্য করতে হবে, তারা এটি দিয়ে কী করতে পারে এবং যদি প্রয়োজন হয় তবে কারা সাহায্য চাইতে পারে তা জানতে সহায়তা করা উচিত। এটি যদি তারা 10 বছরের পুরানো কোনও কিছুর দিকে তাকিয়ে থাকে তবে তা তাদের জানায়।

Answer 11

আমি ব্যক্তিগতভাবে এটি করি না কারণ এটি অতিরিক্ত ডকুমেন্টেশন যা অন্যরা বলেছিল, সংস্করণ নিয়ন্ত্রণে রয়েছে। তবে আমি যদি কিছু ধরণের কুং-ফু কোড স্নিপিত তৈরি করতে যাচ্ছিলাম তবে আমি সম্ভবত আমার আইডিই যা অটো উত্পাদন করতে সক্ষম ছিল তা দিয়ে যেতে চাই।

উদাহরণস্বরূপ, ডেলিফি 7 এ ব্যবহার করা সেই সহায়ক সিএনটুলগুলি ইনস্টল করে আমি টাইপ করি

///a [enter]

এবং বাইরে আসে

//<author></author>

তারপরে আমি টাইপ করি

///d [enter]

এবং বাইরে আসে

 //<date></date>

আমি কল্পনা করতে পারি যে কোনও তৃতীয় পক্ষের ইউটিলিটি এটি গ্রহণ করতে পারে তার সাথে সামঞ্জস্য করে, তবে আমার হিসাবে - আমার এমন একটি স্ট্যান্ডার্ড পেয়েছে যা এমনকি নিজেকে তৈরি করতে এবং দূষিত করতে হয় নি।