প্রতিটি নতুন টেনসরফ্লো বৈশিষ্ট্য মন্তব্যের অনুরোধ (আরএফসি) হিসাবে জীবন শুরু করে।
একটি আরএফসি হ'ল একটি নথি যা প্রয়োজনীয়তা এবং প্রস্তাবিত পরিবর্তনগুলি বর্ণনা করে যা এটি সমাধান করবে। বিশেষত, আরএফসি করবে:
- আরএফসি টেম্পলেট অনুসারে ফর্ম্যাট করা হবে।
- সম্প্রদায় / আরএফসিএস ডিরেক্টরিতে একটি টান অনুরোধ হিসাবে জমা দিন।
- গ্রহণযোগ্যতার পূর্বে আলোচনা এবং একটি পর্যালোচনা বৈঠকের বিষয়বস্তু থাকুন।
টেনসরফ্লো রিকোয়েস্ট ফর কমেন্টস (আরএফসি) এর উদ্দেশ্য হ'ল স্টেকহোল্ডার এবং বিশেষজ্ঞদের কাছ থেকে মতামত গ্রহণের মাধ্যমে এবং ডিজাইনের পরিবর্তনগুলি ব্যাপকভাবে যোগাযোগ করার মাধ্যমে টেনসরফ্লো সম্প্রদায়টিকে উন্নয়নের সাথে জড়িত করা।
কিভাবে একটি আরএফসি জমা দিতে হবে
আরএফসি জমা দেওয়ার আগে, প্রকল্পের অবদানকারী এবং রক্ষণাবেক্ষণকারীদের সাথে আপনার লক্ষ্যগুলি নিয়ে আলোচনা করুন এবং প্রাথমিক প্রতিক্রিয়া পান get সংশ্লিষ্ট প্রকল্পের জন্য বিকাশকারী মেলিং তালিকাটি ব্যবহার করুন (বিকাশকারীরা @ স্পেনফ্রো.অর্গ, বা সংশ্লিষ্ট এসআইএসের তালিকা)।
আপনার আরএফসি খসড়া করুন।
- নকশা পর্যালোচনা মানদণ্ড পড়ুন
- আরএফসি টেম্পলেট অনুসরণ করুন।
- আপনার আরএফসি ফাইলটির নাম
YYYYMMDD
descriptive-name
YYYYMMDD-descriptive-name.md
, যেখানেYYYYMMDD
জমা দেওয়ার তারিখ, এবংdescriptive-name
আপনার আরএফসির শিরোনামের সাথে সম্পর্কিত। (উদাহরণস্বরূপ, যদি আপনার আরএফসি প্যারালাল উইজেটস এপিআই শিরোনাম হয় তবে আপনি ফাইলের নাম20180531-parallel-widgets.md
সমান্তরাল-20180531-parallel-widgets.md
ব্যবহার করতে পারেন। - আপনার কাছে ছবি বা অন্যান্য সহায়ক ফাইল থাকলে
YYYYMMDD-descriptive-name
ফর্মের একটি ডিরেক্টরি তৈরি করুন যাতে এই ফাইলগুলি সংরক্ষণ করা যায়।
আরএফসি খসড়া লেখার পরে এটি জমা দেওয়ার আগে রক্ষণাবেক্ষণকারী এবং অবদানকারীদের কাছ থেকে প্রতিক্রিয়া পান get
বাস্তবায়ন কোড লেখার প্রয়োজন হয় না, তবে এটি আলোচনার নকশা করতে সহায়তা করতে পারে।
একটি স্পনসর নিয়োগ করুন।
- একটি স্পনসর অবশ্যই প্রকল্পের রক্ষণাবেক্ষণকারী হতে হবে।
- পিআর পোস্ট করার আগে আরএফসি-তে স্পনসর সনাক্ত করুন।
আপনি কোনও স্পনসর ছাড়াই একটি আরএফসি পোস্ট করতে পারেন, তবে পিআর পোস্ট করার এক মাসের মধ্যে এখনও কোনও স্পনসর না থাকলে এটি বন্ধ হয়ে যাবে।
আপনার আরএফসিকে টেনসরফ্লো / সম্প্রদায় / আরএফসিএসের কাছে টানার অনুরোধ হিসাবে জমা দিন।
মার্কডাউন ব্যবহার করে আপনার টানার অনুরোধের মন্তব্যে শিরোনাম সারণি এবং উদ্দেশ্য বিভাগের বিষয়বস্তু অন্তর্ভুক্ত করুন। উদাহরণস্বরূপ, দয়া করে এই উদাহরণটি আরএফসি দেখুন । সহ-লেখক, পর্যালোচক এবং স্পনসরদের গিটহাব হ্যান্ডলগুলি অন্তর্ভুক্ত করুন।
জনগণের শীর্ষে মন্তব্যের সময়কাল কত হবে তা চিহ্নিত করুন। PR পোস্ট করা থেকে এটি সর্বনিম্ন দুই সপ্তাহ হওয়া উচিত।
একটি সংক্ষিপ্ত বিবরণ, জনসংযোগ লিঙ্ক এবং পর্যালোচনার জন্য একটি অনুরোধ সহ বিকাশকারী মেইলিং তালিকা ইমেল করুন। পূর্ববর্তী মেলিংগুলির ফর্ম্যাটটি অনুসরণ করুন, যেমন আপনি এই উদাহরণে দেখতে পারেন।
আরএফসিআর পিআর পোস্ট হওয়ার দুই সপ্তাহের বেশি পরে স্পনসর একটি রিভিউ কমিটির বৈঠকের জন্য অনুরোধ করবেন। আলোচনা যদি প্রাণবন্ত হয়, পর্যালোচনাতে যাওয়ার আগে এটি স্থির না হওয়া পর্যন্ত অপেক্ষা করুন। পর্যালোচনা সভার লক্ষ্য হ'ল ছোটখাটো সমস্যা সমাধান করা; আগে থেকেই বড় বিষয়ে sensক্যমত্য হওয়া উচিত।
বৈঠকটি আরএফসিকে অনুমোদন দিতে পারে, তা প্রত্যাখ্যান করতে পারে, বা আবার বিবেচনা করার আগে তার পরিবর্তন প্রয়োজন। অনুমোদিত আরএফসিগুলিকে সম্প্রদায় / আরএফসিএসে একীভূত করা হবে এবং প্রত্যাখ্যাত আরএফসি তাদের পিআর বন্ধ করে দেবে।
আরএফসি অংশগ্রহণকারীরা
আরএফসি প্রক্রিয়াতে অনেক লোক জড়িত:
আরএফসি লেখক - এক বা একাধিক সম্প্রদায়ের সদস্য যারা একটি আরএফসি লিখেছেন এবং প্রক্রিয়াটির মাধ্যমে এটি চ্যাম্পিয়ন করার প্রতিশ্রুতিবদ্ধ
আরএফসি স্পনসর - এমন একজন রক্ষণাবেক্ষণকারী যিনি আরএফসিকে স্পনসর করেন এবং এটি আরএফসি পর্যালোচনা প্রক্রিয়ার মাধ্যমে রাখালেন
পর্যালোচনা কমিটি - রক্ষণকারীদের একটি গ্রুপ যাদের আরএফসি গ্রহণের সুপারিশ করার দায়িত্ব রয়েছে
আরএফসি তাদের প্রয়োজনীয়তা পূরণ করবে কিনা সে সম্পর্কে প্রতিক্রিয়া সরবরাহ করে যে কোনও সম্প্রদায়ের সদস্য সহায়তা করতে পারেন।
আরএফসি স্পনসর
স্পনসর হ'ল একটি প্রকল্প রক্ষণাবেক্ষণকারী আরএফসি প্রক্রিয়াটির সর্বোত্তম সম্ভাব্য ফলাফল নিশ্চিত করার জন্য দায়ী। এটা অন্তর্ভুক্ত:
- প্রস্তাবিত নকশার পক্ষে পরামর্শ নিচ্ছেন।
- বিদ্যমান নকশা এবং শৈলী কনভেনশন মেনে চলার জন্য আরএফসিকে গাইড করে।
- উত্পাদনশীল sensকমত্যে আসার জন্য পর্যালোচনা কমিটির নির্দেশনা।
- যদি পর্যালোচনা কমিটির দ্বারা পরিবর্তনগুলির জন্য অনুরোধ করা হয়, তবে তা নিশ্চিত হয়ে নিন এবং কমিটির সদস্যদের পরবর্তী অনুমোদনের চেষ্টা করুন।
- যদি আরএফসি বাস্তবায়নে চলে যায়:
- প্রস্তাবিত বাস্তবায়ন সুনিশ্চিত করা নকশাকে মেনে চলে।
- সফলভাবে অবতরণ করার জন্য উপযুক্ত পক্ষগুলির সাথে সমন্বয় করুন
আরএফসি পর্যালোচনা কমিটিগুলি
পর্যালোচনা কমিটি approকমত্য ভিত্তিতে সিদ্ধান্ত অনুমোদন, প্রত্যাখ্যান, বা পরিবর্তনের জন্য অনুরোধ করবে কিনা তা স্থির করে। তারা এর জন্য দায়ী:
- নিশ্চিত হওয়া যে জনসাধারণের প্রতিক্রিয়াগুলির মূল আইটেমগুলির জন্য অ্যাকাউন্ট করা হয়েছে।
- PR তে মন্তব্য হিসাবে তাদের সভার নোটগুলি যুক্ত করা।
- তাদের সিদ্ধান্তের কারণ প্রদান করে।
প্রতিটি প্রকল্পের প্রশাসনিক রীতি এবং নেতৃত্ব অনুসারে একটি পর্যালোচনা কমিটি গঠন করা যেতে পারে। মূল টেনসরফ্লো-র জন্য, কমিটি টেনসরফ্লো প্রকল্পে অবদানকারীদের সমন্বয়ে গঠিত হবে যাদের সংশ্লিষ্ট ডোমেন ক্ষেত্রে দক্ষতা রয়েছে।
সম্প্রদায়ের সদস্য এবং আরএফসি প্রক্রিয়া
আরএফসির উদ্দেশ্য হ'ল সম্প্রদায়টি ভালভাবে প্রতিনিধিত্ব করা এবং টেনসরফ্লোতে নতুন পরিবর্তন দ্বারা পরিবেশিত হওয়া নিশ্চিত করা। আরএফসিগুলির পর্যালোচনায় অংশ নেওয়া সম্প্রদায়ের সদস্যদের দায়িত্ব, যেখানে তারা ফলাফল সম্পর্কে আগ্রহী।
কোনও আরএফসিতে আগ্রহী সম্প্রদায়ের সদস্যদের উচিত:
- বিবেচনার জন্য পর্যাপ্ত সময় দেওয়ার জন্য যত তাড়াতাড়ি সম্ভব প্রতিক্রিয়া সরবরাহ করুন ।
- প্রতিক্রিয়া দেওয়ার আগে আরএফসিগুলি ভালভাবে পড়ুন ।
- নাগরিক এবং গঠনমূলক হন ।
নতুন বৈশিষ্ট্য বাস্তবায়ন করা হচ্ছে
কোনও আরএফসি অনুমোদিত হয়ে গেলে বাস্তবায়ন শুরু হতে পারে।
আপনি যদি কোনও আরএফসি বাস্তবায়নের জন্য নতুন কোডে কাজ করছেন:
- আপনি আরএফসিতে অনুমোদিত বৈশিষ্ট্য এবং নকশাটি নিশ্চিত করেছেন তা নিশ্চিত করুন। কাজ শুরু করার আগে প্রশ্ন জিজ্ঞাসা করুন এবং পদ্ধতির বিষয়ে আলোচনা করুন।
- নতুন বৈশিষ্ট্যগুলিতে অবশ্যই নতুন ইউনিট পরীক্ষা অন্তর্ভুক্ত থাকতে হবে যা প্রত্যাশা অনুযায়ী বৈশিষ্ট্যটি কাজ করে যাচাই করে। কোড লেখার আগে এই পরীক্ষাগুলি লেখা ভাল ধারণা।
- টেনসরফ্লো কোড স্টাইল গাইড অনুসরণ করুন
- প্রাসঙ্গিক এপিআই ডকুমেন্টেশন যুক্ত বা আপডেট করুন। নতুন ডকুমেন্টেশনে আরএফসিটি উল্লেখ করুন।
- পরিপূর্ণ কোনো অন্য নির্দেশিকাও অনুসরণ
CONTRIBUTING.md
প্রকল্পে ফাইল রেপো আপনি অবদান করছি। - আপনার কোড জমা দেওয়ার আগে ইউনিট পরীক্ষা চালান।
- নতুন কোডটি সফলভাবে অবতরণ করতে আরএফসি স্পনসর দিয়ে কাজ করুন।
বার উঁচু রাখা
আমরা প্রতিটি অবদানকারীকে উত্সাহিত এবং উদযাপন করার সময়, আরএফসি গ্রহণের জন্য বারটি ইচ্ছাকৃতভাবে উচ্চ রাখা হয়। একটি নতুন বৈশিষ্ট্য প্রত্যাখ্যাত হতে পারে বা এই পর্যায়ের যে কোনও একটিতে উল্লেখযোগ্য সংশোধন প্রয়োজন:
- প্রাসঙ্গিক মেলিং তালিকায় প্রাথমিক নকশা কথোপকথন।
- স্পনসর নিয়োগে ব্যর্থতা।
- প্রতিক্রিয়া পর্বের সময় সমালোচনামূলক আপত্তি।
- নকশা পর্যালোচনা চলাকালীন sensকমত্য অর্জনে ব্যর্থতা।
- বাস্তবায়নের সময় উত্থাপিত উদ্বেগগুলি (উদাহরণস্বরূপ: পিছনে সামঞ্জস্যতা অর্জনে অক্ষমতা, রক্ষণাবেক্ষণ সম্পর্কে উদ্বেগ)।
এই প্রক্রিয়াটি যদি ভালভাবে চলতে থাকে তবে আরএফসিগুলি পরবর্তী পর্যায়ে না হয়ে পূর্বের পর্যায়ে ব্যর্থ হবে বলে আশা করা হচ্ছে। অনুমোদিত আরএফসি বাস্তবায়নের প্রতিশ্রুতির কোনও গ্যারান্টি নয় এবং প্রস্তাবিত আরএফসি বাস্তবায়নের স্বীকৃতি এখনও স্বাভাবিক কোড পর্যালোচনা প্রক্রিয়ার সাপেক্ষে।
এই প্রক্রিয়া সম্পর্কে আপনার যদি কোনও প্রশ্ন থাকে তবে নির্মাতারা বিকাশকারীদের মেলিং তালিকায় জিজ্ঞাসা করতে পারেন বা সেন্সরফ্লো / কমিউনিটিতে একটি সমস্যা দায়ের করতে পারেন।