Git और GitHub

आप क्या कर सकते हैं

• कभी टोकन हाथ में लिए बिना कनेक्ट करें: PocketCode GitHub के device flow का इस्तेमाल करता है, जिसे client secret नहीं चाहिए और जो आपके approve करने तक हर कुछ सेकंड में जाँच करता है।
• Approve करने से पहले देखें कि क्या माँगा जा रहा है: अनुमतियाँ repo, read:user और user:email। repo वही है जो private repositories तक पहुँचता है।
• इसी एक अकाउंट का इस्तेमाल clone, publish, fetch, pull, push, GitHub PRs & Issues शीट और CI फ़ीड के लिए करें।

आप क्या नहीं कर सकते, और क्यों

• Free पर दूसरा GitHub अकाउंट (या किसी भी provider का दूसरा अकाउंट) कनेक्ट करना: हर provider का पहला अकाउंट मुफ़्त है, उससे ज़्यादा Pro में हैं।Pro
• कोड वाला sign-in तब इस्तेमाल करना जब GitHub ने उसे PocketCode के OAuth ऐप के लिए चालू न किया हो: तब शीट बताती है कि GitHub अभी इसे नहीं दे रहा।थर्ड पार्टी

आप क्या कर सकते हैं

• Private और public दोनों तरह की repositories clone करें, GitHub, GitLab या Bitbucket से, बशर्ते वह अकाउंट कनेक्टेड हो।
• पूरी history पाएँ: clone shallow नहीं होता।

आप क्या नहीं कर सकते, और क्यों

• URL से clone करना, या ऐसी repository clone करना जो आपके अकाउंट की सूची में नहीं है।अभी नहीं
• दूसरे होस्ट से clone करना (GitHub Enterprise, self-hosted GitLab, Gitea, Codeberg…): सिर्फ़ github.com, gitlab.com और bitbucket.org समर्थित हैं।जानबूझकर
• कनेक्टेड अकाउंट के बिना clone करना, public repository भी नहीं।नेटवर्क ज़रूरी
• Submodule या Git LFS कंटेंट लाना: submodule clone नहीं होते, और LFS फ़ाइलें अपने छोटे टेक्स्ट pointer के रूप में ही रहती हैं।अभी नहीं
• असली प्रगति देखना: बार चरणों में बढ़ता है, bytes के हिसाब से नहीं।अभी नहीं

आप क्या कर सकते हैं

• GitHub, GitLab या Bitbucket पर publish करें।
• वही नतीजा Git → Create on GitHub and connect से पाएँ, या पहले से मौजूद repository को Link a repository I already have से जोड़ें (प्रोजेक्ट कार्ड पर Git देखें)।

आप क्या नहीं कर सकते, और क्यों

• कोई सर्विस कनेक्ट न हो तब publish करना: शीट कहती है Connect GitHub, GitLab or Bitbucket in Services first, और आप वहाँ से कनेक्ट नहीं कर सकते।नेटवर्क ज़रूरी
• किसी दूसरे होस्ट पर publish करना।जानबूझकर

आप क्या कर सकते हैं

• किसी फ़ाइल का diff पढ़ने के लिए उसे टैप करें: जोड़ी और हटाई गई लाइनें रंग में, लाइन नंबर और +N −M कुल के साथ। Swap दोनों तरफ़ की अदला-बदली करता है।
• फ़ाइल को उसकी पंक्ति पर Stage / Unstage से ले जाएँ (नई फ़ाइल के लिए Track & Stage), या पूरे समूह को Stage All / Unstage All से।
• हेडर में Refresh, Pull और Push आइकन इस्तेमाल करें। Pull और Push बिना पूछे तुरंत चलते हैं, और हर एक एक message के साथ ख़त्म होता है (Pushed या Push failed: …)।
• जब commit करने को कुछ न हो तब No changes detected (Working tree clean.) दिखता है।

आप क्या नहीं कर सकते, और क्यों

• यहीं repository शुरू करना: जो प्रोजेक्ट अभी repository नहीं है उसमें पैनल सिर्फ़ No changes detected कहता है। Tracking Projects → Git से या टर्मिनल के Git Panel से शुरू करें।अभी नहीं
• Fetch करना, branch बनाना या बदलना, amend करना, किसी फ़ाइल के बदलाव discard करना, tags या remotes एडिट करना: एडिटर में इनके लिए बटन नहीं है। Projects और टर्मिनल इनमें से ज़्यादातर कर देते हैं (नीचे देखें)।अभी नहीं
• ↑↓ काउंटर पर भरोसा करना कि वे हमेशा ताज़ा हैं: वे सिर्फ़ pull या push के बाद बदलते हैं, क्योंकि एडिटर fetch नहीं कर सकता।अभी नहीं

आप क्या कर सकते हैं

• बदलाव का हर ब्लॉक Hunk @ line N के रूप में अपनी हटाई और जोड़ी गई लाइनों के साथ दिखता है।
• हर hunk शुरू में Stage होता है; जिन्हें छोड़ना है उन पर Skip टैप करें। N of M accepted उन्हें गिनता है।
• सारे hunk चुने हों तो नीचे का बटन Stage all कहता है, वरना Stage N। यह सिर्फ़ उन्हीं hunk को अगले commit में जोड़ता है और डिस्क पर आपकी फ़ाइल को नहीं छेड़ता।

आप क्या नहीं कर सकते, और क्यों

• किसी hunk को अलग-अलग लाइनों में बाँटना।अभी नहीं
• नई या पहले से staged फ़ाइल को hunk से stage करना: आइकन सिर्फ़ Changes के नीचे दिखता है।अभी नहीं

आप क्या कर सकते हैं

• विचारों के लिए AI message टैप करें। कोई स्टाइल चुनें (Conventional, Descriptive, Imperative या Emoji), कोई सुझाव टैप करें और Use this message: यह बॉक्स भर देता है, और Commit आपको फिर भी टैप करना है।
• अपने नाम से commit करें: एडिटर के commit में वही नाम और ईमेल जाता है जो repository में सेव है, इसलिए पहले Your name on commits सेट करें (Projects → Git)।

आप क्या नहीं कर सकते, और क्यों

• एडिटर से आख़िरी commit को amend करना: Projects → Commit में Amend last commit इस्तेमाल करें।अभी नहीं

आप क्या कर सकते हैं

• Ahead और Behind, Files, commit (सूची 50 पर रुकती है, पर Ahead असली गिनती है) और बदले हुए paths पढ़ें। एक जैसी branch पर No differences between these branches लिखा आता है।

आप क्या नहीं कर सकते, और क्यों

• तुलना से किसी फ़ाइल का diff खोलना, या remote branch की तुलना करना: सिर्फ़ लोकल branch सूचीबद्ध होती हैं।अभी नहीं

आप क्या कर सकते हैं

• पुष्टि से पहले Optional stash message टाइप करें: वह entry के साथ सेव होता है और सूची में उसका शीर्षक बनकर दिखता है। इसके बिना Git अपना WIP on … शीर्षक लिखता है।
• नतीजा एक message में पढ़ें: Stash saved: …, Stash applied and removed (Pop), Stash applied (kept) (Apply) या Stash removed (Drop)।

आप क्या नहीं कर सकते, और क्यों

• नई (untracked) फ़ाइलें stash करना: सिर्फ़ उन फ़ाइलों के बदलाव अलग रखे जाते हैं जिन्हें Git पहले से track करता है।अभी नहीं
• किसी ख़ास entry को pop करना: Pop हमेशा सबसे नई entry को apply करके हटाता है, चाहे आपने कोई भी पंक्ति खोली हो।अभी नहीं
• Apply किया गया stash टकराए तो conflict हल करना: इसके लिए कोई resolver नहीं है।अभी नहीं

आप क्या कर सकते हैं

• फ़ाइल खुली होने पर Blame टैप करें: एक ही commit की लगातार लाइनें साथ में समूहित होती हैं, author, Line N (या रेंज) और 7 अक्षरों के hash के साथ।
• किसी ब्लॉक को टैप करें, फिर View commit, ताकि उस फ़ाइल के लिए उस commit का diff पढ़ सकें।
• स्टेटस बार देखें: वह branch के नाम के पास, आपके कर्सर वाली लाइन के लिए author · कितनी देर पहले दिखा सकता है। किसी भी एक को टैप करके Source Control खोलें। जो लाइनें आपने commit नहीं कीं उन पर Not Committed Yet दिखता है।

आप क्या नहीं कर सकते, और क्यों

• दूसरी branch या commit पर blame करना, या स्टेटस बार का blame छिपाना: इसकी कोई सेटिंग नहीं है।अभी नहीं
• वह सापेक्ष समय अपनी भाषा में पढ़ना: just now, 5 min ago, yesterday… हमेशा अंग्रेज़ी में रहते हैं।अभी नहीं

आप क्या कर सकते हैं

• फ़ाइल खुली होने पर File History टैप करें, उसे छूने वाले पिछले 50 commit के लिए (message, hash, author, कितना पुराना), और View diff से देखें कि हर एक ने उस फ़ाइल में क्या बदला।
• जिस फ़ाइल को कभी छुआ नहीं गया उस पर No commit history for this file लिखा आता है।

आप क्या नहीं कर सकते, और क्यों

• 50 से ज़्यादा commit देखना।जानबूझकर
• फ़ाइल को पुराने वर्शन पर restore करना, या पंक्ति से revert करना: Revert Projects → Git → History में है, और Local History बिना सेव किए काम को संभालता है।अभी नहीं

आप क्या कर सकते हैं

• Repository में फ़ाइल explorer हर बदली फ़ाइल पर निशान लगाता है (modified, added, untracked, deleted या renamed), बदलाव वाले फ़ोल्डर पर निशान लगाता है, और नीचे branch, ↑↓ और बदली फ़ाइलों की संख्या वाला footer दिखाता है। वह वही status पढ़ता है जो Source Control पढ़ता है।
• स्टेटस बार में branch का नाम Source Control खोलता है।
• Git repository के बाहर कोई निशान नहीं होता और कोई footer नहीं होता।

आप क्या नहीं कर सकते, और क्यों

—

आप क्या कर सकते हैं

• हर फ़ाइल के चेकबॉक्स से फ़ाइलों को Staged (n) और Unstaged & Untracked (n) के बीच ले जाएँ, या Stage All / Unstage All इस्तेमाल करें।
• Commit message टाइप करें और Commit टैप करें। इसके लिए message और कम से कम एक staged फ़ाइल चाहिए, और यह आपके लिए कुछ stage नहीं करता: कुछ भी staged न हो तो कहता है No staged files. Use 'Stage All' to add changes.
• Amend last commit पर टिक करें (Modify the previous commit with the current changes): बटन Amend Commit बन जाता है।
• एक बार में commit और upload के लिए Commit & Push टैप करें (सिर्फ़ तब जब प्रोजेक्ट में remote हो)।
• Git जिस फ़ाइल को पहले से track करता है उसके uncommitted बदलाव उसकी पंक्ति पर Discard changes आइकन से हटाएँ। यह staged या नई फ़ाइलों पर नहीं दिखता।
• Author: repository में सेव नाम और ईमेल; वे न हों तो आपके PocketCode अकाउंट के।

आप क्या नहीं कर सकते, और क्यों

—

आप क्या कर सकते हैं

• Branch: आपकी लोकल branch। किसी एक को टैप करके उस पर जाएँ, या Create new branch इस्तेमाल करें: Switch to this branch (डिफ़ॉल्ट रूप से चुना हुआ) तुरंत उस पर ले जाता है।
• Your name on commits: repository जो user.name और user.email सेव करती है उन्हें सेट करें। वे शुरू में repository, आपकी कनेक्टेड सर्विस या आपके अकाउंट से भरे होते हैं।

आप क्या नहीं कर सकते, और क्यों

• ऐसी repository में जिसमें अभी remote नहीं है, branch बदलना या History और Tags देखना: वे पंक्तियाँ तभी दिखती हैं जब origin हो। टर्मिनल का Git Panel लोकल में branch बदल सकता है।अभी नहीं
• Branch delete या rename करना, या remote branch सूचीबद्ध करना: यहाँ सिर्फ़ लोकल branch हैं।अभी नहीं

आप क्या कर सकते हैं

• Create Tag: v1.0.0 जैसा नाम और एक वैकल्पिक message। Message हो तो tag annotated होता है।
• किसी tag को उसके आइकन से delete करें।
• Push Tags उन्हें upload करता है (सिर्फ़ remote के साथ)।

आप क्या नहीं कर सकते, और क्यों

—

आप क्या कर सकते हैं

• Status: Staged, Modified और Untracked फ़ाइलों की गिनती और सूचियाँ, या Working tree is clean।
• Branches: किसी branch पर जाने के लिए उसे टैप करें, या New branch।
• Log: पिछले 30 commit।
• Actions: Commit changes (message पूछता है और पैनल बंद कर देता है), Pull, Push, Stash, Stash Pop, Fetch, Add All और Reset (सब कुछ index से बाहर निकाल देता है)।
• Repository न हो तो No Git repository here Initialize repository का विकल्प देता है।

आप क्या नहीं कर सकते, और क्यों

• लोकल shell में Diff क्रिया इस्तेमाल करना: वह सिर्फ़ SSH पर है।जानबूझकर
• Message के साथ stash, किसी एक फ़ाइल को discard करना, merge, rebase, tag या blame: इस पैनल में नहीं। यह खुद यह कहता है: Local panel backed by JGit; for full git use the editor's Source Control।अभी नहीं
• कनेक्टेड अकाउंट के बिना push या pull करना: पैनल वजह के साथ Git: … दिखाता है और sign-in नहीं खोलता।नेटवर्क ज़रूरी

आप क्या कर सकते हैं

• फ़ाइलों को एक-एक करके हल करें और गिनती घटते देखें।
• Abort Merge से छोड़ दें: यह Abort merge? पूछता है और Abort पुष्टि करता है; message कहता है Merge aborted।

आप क्या नहीं कर सकते, और क्यों

—

आप क्या कर सकते हैं

• कुछ भी बदलने से पहले PocketCode आपकी branch का मौजूदा सिरा refs/pocketcode/rebase-backup/<branch> के रूप में सेव कर लेता है।
• Uncommitted बदलावों के साथ rebase कभी शुरू नहीं होता, जब तक आप उन्हें पहले stash न कर दें।
• Abort सब कुछ पलट देता है (branch, index और working tree) और आपका अपना stash फिर से apply कर देता है।
• योजना .git के अंदर सेव होती है, इसलिए बीच में ऐप बंद हो गया हो तब भी Continue और Skip this commit काम करते हैं।
• Restore backup branch को सेव किए सिरे पर वापस ले जाता है, पर सिर्फ़ साफ़ working tree के साथ; rebase के बाद बने commit फिर सिर्फ़ Git reflog में बचे रहते हैं।

आप क्या नहीं कर सकते, और क्यों

• Commit का क्रम बदलना: शीट इसकी अनुमति नहीं देती।जानबूझकर
• Edit क्रिया इस्तेमाल करना: Git amend करने के बजाय नया commit बना देता, इसलिए वह नहीं दी जाती।जानबूझकर
• जो पहला commit आप रखते हैं उस पर Squash या Fixup से शुरू करना, या हर commit drop कर देना: शीट दोनों को मना करती है।जानबूझकर
• Remote branch पर rebase करना, या उस branch के अलावा किसी और branch को rebase करना जिस पर आप हैं: सिर्फ़ लोकल branch दी जाती हैं, और detached HEAD मना कर दिया जाता है।अभी नहीं
• इसे Source Control से, बिना remote वाले प्रोजेक्ट से, या ऐसे प्रोजेक्ट से खोलना जिसका origin github.com पर नहीं है।अभी नहीं

आप क्या कर सकते हैं

• Open, Mine, Review requested, Closed या All से फ़िल्टर करें। Mine और Review requested आपके फ़ोन पर, आपके GitHub login के आधार पर फ़िल्टर होते हैं।
• सूची पढ़ें: स्थिति (Open, Draft, Merged, Closed), नंबर, title, author, कितना पुराना, माँगे गए reviews और labels।
• किसी एक को खोलें: Summary (description, head → base, बदली फ़ाइलें, +N / −M, commit, assignees, labels, Checks और Reviews अपनी स्थिति के साथ), Files · N (+/− के साथ paths) और Comments · N।
• देखें कि वह merge क्यों नहीं हो सकता: एक बैनर Can't merge: … पढ़ता है और उसके बाद लागू होने वाली वजहें (merge conflicts, a failing check, changes requested)।
• Write a comment… एक conversation comment पोस्ट करता है। Close PR pull request को बंद करता है।
• Merge में Merge commit, Squash and merge और Rebase and merge मिलते हैं। ऐप वही head commit भेजता है जो उसने आपको दिखाया था, इसलिए अगर इस बीच किसी ने push किया तो GitHub वे commit merge करने के बजाय मना कर देता है जो आपने देखे नहीं।
• New pull request from … (मौजूदा branch चाहिए): title, description, Base branch और Head branch, Create as draft और labels, फिर Create pull request।

आप क्या नहीं कर सकते, और क्यों

• Review submit करना (approve या changes request), किसी लाइन पर comment करना, या pull request का diff पढ़ना: reviews दिखते हैं पर सिर्फ़ पढ़ने के लिए, और Files paths सूचीबद्ध करता है पर उन्हें खोलता नहीं।अभी नहीं
• Pull request बनाते समय reviewers चुनना।अभी नहीं
• Pull request दोबारा खोलना, उसका title या description एडिट करना, auto-merge चालू करना या उसकी branch अपडेट करना।अभी नहीं
• GitLab merge request, Bitbucket pull request या GitHub Enterprise इस्तेमाल करना: सिर्फ़ github.com की repositories पढ़ी जाती हैं।जानबूझकर

आप क्या कर सकते हैं

• Open, My issues (आपको assign किए गए), Closed या All से फ़िल्टर करें।
• सूची पढ़ें (स्थिति, नंबर, comments की गिनती, author, labels) और किसी एक को खोलकर उसका body, तारीख़ें, assignees, labels, milestone, comments और comment बॉक्स देखें।
• Close issue उसे completed के रूप में बंद करता है। Create issue में title, description और labels लगते हैं।

आप क्या नहीं कर सकते, और क्यों

• Issue बनाते समय milestone या assignees चुनना, किसी को दोबारा खोलना, एडिट करना, बाद में label लगाना या खोजना।अभी नहीं

आप क्या कर सकते हैं

• कोई pull request खोलें, फिर CI टैब: उसके head commit की checks (GitHub Actions runs, दूसरे ऐप्स की checks और classic statuses) एक सारांश के नीचे, जैसे All checks passed, Some checks failed या Checks in progress।

आप क्या नहीं कर सकते, और क्यों

• पहले pull request खोले बिना CI देखना (टैब कहता है Select a PR to see its CI status), logs पढ़ना, या कोई run दोबारा चलाना या रद्द करना।अभी नहीं

आप क्या कर सकते हैं

• Alerts खोलें: आपकी वे GitHub notifications जिनमें आप शामिल हैं। हर पंक्ति में उसके प्रकार का आइकन (review requested, approved, changes requested, merge, comment, assigned, mention, CI passed या failed, release), title और repo · reason होता है।
• किसी न पढ़े हुए को पढ़ा हुआ करने के लिए टैप करें, या Mark all read। कुछ न बचे तो You're all caught up लिखा आता है।

आप क्या नहीं कर सकते, और क्यों

• Notification के पीछे का pull request या issue खोलना: टैप करना उसे सिर्फ़ पढ़ा हुआ चिह्नित करता है।अभी नहीं
• Fine-grained टोकन से notifications देखना: GitHub उन्हें सिर्फ़ classic टोकन या OAuth sign-in को दिखाता है, और शीट यह बताती भी है।थर्ड पार्टी

आप क्या कर सकते हैं

• हर सफल सेव के बाद एक वर्शन सेव होता है, और सिर्फ़ तब जब टेक्स्ट पिछले सेव किए वर्शन से अलग हो। यह प्रोजेक्ट की फ़ाइलों के लिए और प्रोजेक्ट के बाहर से खोली गई फ़ाइलों के लिए भी काम करता है।
• यह हर फ़ाइल के लिए 50 वर्शन और कुल 50 MB तक रखता है, compressed नापकर। कुल सीमा पार होने पर किसी भी फ़ाइल के सबसे पुराने वर्शन पहले जाते हैं। समय के आधार पर कोई expiry नहीं है।
• वर्शन PocketCode के private स्टोरेज में रहते हैं, आपके प्रोजेक्ट के अंदर कभी नहीं, इसलिए वे Git changes के रूप में कभी नहीं दिखते। फ़ाइल का नाम बदलने या उसे ले जाने पर उसकी history साथ चलती है।

आप क्या नहीं कर सकते, और क्यों

• बड़ी फ़ाइलों के वर्शन रखना: एडिटर 512 KiB, 10,000 लाइनों या 2,000 अक्षरों की लाइन वाली फ़ाइलें अपने light mode में खोलता है, और वे सेव नहीं होतीं।जानबूझकर
• सीमाएँ बदलना, या किसी वर्शन को pin या label करना।जानबूझकर

आप क्या कर सकते हैं

• Base चुनें: On disk (The saved version of this file), HEAD (The last git commit), Clipboard (The copied text) या Another open tab।
• जो base उपलब्ध नहीं होता वह वजह बताता है: No Git repository, The clipboard is empty या No other tabs are open।
• Diff का शीर्षक file ↔ base होता है; Swap दोनों तरफ़ की अदला-बदली करता है।

आप क्या नहीं कर सकते, और क्यों

• Diff से एडिट करना या उसे दो कॉलम में देखना: यह बदली हुई लाइनों की एक एकीकृत सूची है।जानबूझकर