GitHub Issues लगभग सबसे बेहतरीन नोटबुक है

 (simonwillison.net)
19 पॉइंट द्वारा GN⁺ 2025-05-27 | 1 टिप्पणियां | WhatsApp पर शेयर करें
  • GitHub Issues मुफ़्त होने के साथ सार्वजनिक/निजी नोट्स और सहयोग के लिए एक शक्तिशाली टूल है
  • Markdown support, code highlighting, image·video drag and drop, और interlinking जैसी सुविधाओं के कारण यह बेहतरीन नोट-लेखन अनुभव देता है
  • शक्तिशाली search और API के ज़रिए automation, backup, और external integration संभव है
  • इसकी एकमात्र कमी sync होने वाली offline सुविधा की अनुपस्थिति है, इसलिए network connection न होने पर इसका उपयोग कठिन हो जाता है
  • checklist, large-scale handling, LLM integration, data backup, और reliability भी इसके प्रमुख फ़ायदे हैं

GitHub Issues का नोट्स के लिए मूल्य

  • GitHub Issues को लगभग सबसे बेहतरीन online notebook tools में गिना जा सकता है
  • इसमें मुफ़्त में असीमित public और private notes लिखे और manage किए जा सकते हैं
  • Markdown format support बहुत उत्कृष्ट है, यह लगभग सभी programming languages के लिए syntax highlighting देता है, और images को सीधे note में drag and drop करना भी संभव है

लिंक और इंटरलॉकिंग फीचर

  • किसी issue के भीतर दूसरे issue का URL Markdown list में जोड़ने पर यह अपने-आप शीर्षक लाता है, और दोनों के बीच लिंक भी स्वतः बन जाते हैं
  • issue visibility rules लागू होते हैं, इसलिए private issues बाहर दिखाई नहीं देते

शक्तिशाली search और API automation

  • repository scope, user के सभी repositories, और पूरे GitHub में तेज़ और सटीक search इसकी बड़ी ताकत है
  • API से note data को आसानी से export किया जा सकता है या नए notes बनाए और संपादित किए जा सकते हैं
  • issue events के साथ GitHub Actions जोड़कर व्यापक automation भी लागू किया जा सकता है

कमी: offline sync का अभाव

  • इसकी एकमात्र कमी यह है कि internet connection न होने पर sync नहीं होता
  • इसी कारण mobile पर अक्सर Apple Notes जैसे offline/sync support वाले apps के साथ इसका इस्तेमाल किया जाता है

सुरक्षा, सुविधा, checklist, और large-scale scalability

  • सुरक्षा को लेकर चिंता अपेक्षाकृत कम है। कंपनियाँ GitHub की reliability पर निवेश करती हैं, और platform पर भरोसा काफ़ी ऊँचा है
  • सभी note platforms में bugs के कारण data leak होने का जोखिम होता है, इसलिए sensitive data इसमें store नहीं किया जाता
  • billing या self-hosting की ज़रूरत न होने से notes खोने का जोखिम कम रहता है
  • Markdown checklist(- [ ] item) या issue reference(- [ ] #ref) का उपयोग बहुत उपयोगी है
    • संबंधित issue बंद होते ही वह अपने-आप check हो जाता है
  • अलग-अलग backup methods (जैसे: github-to-sqlite) भी आज़माए जा सकते हैं
  • इसकी scalability भी शानदार है; vscode repository में 1.9 लाख और flutter repository में 1 लाख से अधिक issues manage किए जाने के उदाहरण मौजूद हैं

LLM और अन्य उपयोग

  • issue data को LLM जैसे generative AI में pipe करना भी सहज है
  • वास्तव में 50 से अधिक comments और 1.5 साल लंबे issue thread का summary बनाकर उसे नए comment के रूप में व्यवस्थित करने का अनुभव भी है

activity data का aggregation और उपयोग

  • GitHub पर अपने बनाए गए issues और comments की संख्या को GraphQL query से aggregate किया जा सकता है
{  
  viewer {  
    issueComments {  
      totalCount  
    }  
    issues {  
      totalCount  
    }  
  }  
}
  • वास्तविक परिणाम 9,413 issues, 39,087 comments, कुल 48,500 थे, जो उल्लेखनीय है

निष्कर्ष

  • GitHub Issues की ताकतें मुफ़्त उपयोग, collaboration, automation, search, scalability, और versatility हैं
  • अगर offline sync जुड़ जाए, तो यह व्यावहारिक रूप से सबसे बेहतरीन digital notebook solution होगा

संबंधित पढ़ाई

1 टिप्पणियां

 
GN⁺ 2025-05-27
Hacker News राय

  • पहले अपनी शादी की तैयारी के दौरान project management tool के रूप में GitHub Issues इस्तेमाल करने का अनुभव साझा किया। शुरुआत में पत्नी को इस पर शक था, लेकिन label जोड़ना, search करना आदि की वजह से collaboration बहुत आसान हो गया और शादी की तैयारी के काम समय पर पूरे हो गए। याद है कि bookmark के ज़रिए issue tracker पर सीधे जाने वाला link बनाना सबसे मुश्किल हिस्सा था। हाल ही में घर बदलते समय भी GitHub Issues का इस्तेमाल डिब्बों को व्यवस्थित करने के लिए किया। हर डिब्बे के लिए एक issue बनाया, description में डिब्बे की सामग्री लिखी, और डिब्बे पर issue number लिख दिया, जिससे बाद में GitHub search के जरिए आसानी से पता चल जाता था कि किस डिब्बे में क्या रखा है

    • जिज्ञासा कि क्या इसके अलावा कोई और solution भी आज़माया गया था, और अगर हाँ तो वह क्यों कम पड़ा

    • एक सीधा सवाल कि डिब्बे के बाहर ही सामग्री लिख देना क्या काफी नहीं होता

    • Hacker News पर देखा गया घर की मरम्मत वाले project का किस्सा याद आया। लगता है कि वह अब GitHub पर नहीं है, लेकिन उस project का link साझा किया गया

    • पिछली नौकरी में GitLab को पूरे project management tool के रूप में इस्तेमाल करने की कोशिश की थी, लेकिन projects के बीच reference feature न होने से इसे अपनाना रुक गया। open source projects के लिए यह उपयुक्त है, लेकिन मौजूदा कंपनी में GitLab, Youtrack को replace कर सकता है, और Upsource को तो पहले ही replace किया जा चुका है

    • xkcd कॉमिक 1172 याद आ गई। इस तरह के मज़ेदार किस्से बहुत हैं, और दुनिया में अजीब workflow रखने वाले लोग भी काफी हैं। फिर भी, ऐसे कामों के लिए ठीक tool का इस्तेमाल करना हमेशा बेहतर होता है। वैसे, विदेश शिफ्टिंग के समय Org mode में काम व्यवस्थित करने का अनुभव भी रहा। निजी जानकारी Microsoft को सौंपना बिल्कुल मंज़ूर नहीं

  • एक दिलचस्प बात साझा की गई। नीचे दिया गया GraphQL query अगर GitHub GraphQL Explorer में paste करें, तो अब तक GitHub पर पोस्ट किए गए issues और comments की कुल संख्या तुरंत देखी जा सकती है

    {
  viewer {
    issueComments {
      totalCount
    }
    issues {
      totalCount
    }
  }
}

    इनके अनुसार, 9,413 issues और 39,087 comments सहित कुल 48,500 दर्ज हैं

  • लगा था कि privacy पर पहला comment आएगा, लेकिन आश्चर्यजनक रूप से ऐसा नहीं हुआ। खुद बहुत ज़्यादा notes नहीं रखते, लेकिन इसे email से भी ज़्यादा निजी data मानते हैं। ऐसे निजी data से LLM training कराना पसंद नहीं। यह भी सवाल उठाया गया कि Microsoft private repository की privacy पर कोई गारंटी देता भी है या नहीं

    • GitHub Issues में बेहद संवेदनशील कंपनी secrets होने के कारण security और privacy बहुत मज़बूत होने का अनुमान। कई कंपनियाँ source code और उससे जुड़े artifacts GitHub को सौंपती हैं और इसके लिए काफ़ी पैसे देती हैं, इसलिए trust बनाना GitHub के business model का मूल है। अपनी तरफ़ से secrets पर model training जैसा जोखिम नहीं लेगा, ऐसा मत

    • "क्या Microsoft private repository privacy की गारंटी देता है" इस सवाल पर संबंधित चर्चा का link यहाँ साझा किया गया

  • "GitHub की search शानदार है" इस दावे पर सवाल उठाया गया। उदाहरण के लिए, अगर कोई comment ठीक-ठीक "current logs could do with a bit of redesign" हो, तब भी उसे ढूँढने के लिए quotes लगानी पड़ती हैं, और typo (जैसे "redesing") होने पर search fail हो जाती है

    • सहमति जताई गई। GitHub search बस "search" है, "शानदार search" नहीं

  • मेरी तरह बहुत से लोग सबसे अच्छा notes app ढूँढने की कोशिश करते हैं, लेकिन आख़िरकार फिर Git repo में Markdown files जमा करने वाले तरीके पर लौट आते हैं

    • अगर यह तरीका जारी रखना है, तो Obsidian + Git Plugin का संयोजन सबसे अच्छा लगा। desktop पर शानदार काम करता है, लेकिन iOS पर थोड़ा setup चाहिए

    • एक मुफ्त open source notes app आज़माने का सुझाव। यह बताते हुए कि वे developer के customer हैं, em को व्यक्तिगत सोच को व्यवस्थित करने के लिए एक सुंदर और minimal notes app बताया गया

    • उन apps की तुलना में जो सभी devices पर automatic two-way sync देती हैं, हर नई/संपादित note पर manually commit/push/pull करना थोड़ा पुराना तरीका लगता है

    • खुद भी ऐसा ही करते हैं, लेकिन Markdown की जगह Org-mode files इस्तेमाल करते हैं और ज़रूरत पड़ने पर थोड़ा-थोड़ा करके org-roam tags जोड़ते हैं

    • Apple Notes और Markdown folders के बीच झूलते रहने का कष्टदायक अनुभव साझा किया गया। Markdown folders future compatibility के लिहाज़ से अच्छे हैं, लेकिन Apple Notes design, simplicity और media support में शानदार है। जितने ज़्यादा features किसी Markdown app में होते हैं, वह उतनी ही बंद प्रकृति की होती जाती है, और reading app को भी उन सभी features का support चाहिए। आख़िरकार Apple Notes पर बने रहने का फ़ैसला किया, लेकिन इस बार फिर Obsidian के ज़रिए Markdown folders में manual migration चल रहा है। export का इस्तेमाल किया, लेकिन format इतना बिगड़ा हुआ निकला कि सभी notes को हाथ से ठीक करना पड़ रहा है

  • iCloud के "keep downloaded" option से अब सभी folders और files को local में रखा जा सकता है। इसके चलते iCloud में files रखने वाली सभी apps अब offline काम और online automatic sync दोनों support कर सकती हैं

    • sync conflicts कैसे संभाले जाते हैं और sync cycle कैसी है, इस पर जिज्ञासा

    • पूछा गया कि folder move होने पर क्या iCloud अब भी download करके फिर upload करने वाला तरीका ही इस्तेमाल करता है

  • vendor lock-in से बचने के लिए Codeberg इस्तेमाल करने या खुद Forgejo host करने का विकल्प बताया गया

    • खुद host न करना पड़े और लागत '0' हो, यही GitHub Issues का बड़ा फायदा है। setup mistake या billing problem की वजह से notes खोने का जोखिम नहीं चाहिए

  • यह राय कि GitHub Issues सबसे अच्छा bug tracker/ticketing system है। interface को intuitive, simple और fast बताया गया। बस थोड़ा डर है कि कहीं Microsoft redesign इसे खराब न कर दे

    • काम के दौरान कई issue trackers इस्तेमाल किए, लेकिन GitHub में कुछ अहम features की कमी महसूस हुई। जैसे comments से अलग issue summary न लिख पाना, advanced access control का अभाव (कुछ issues सिर्फ कुछ लोगों को ही दिखाना संभव नहीं), और private personal notes जोड़ने की सुविधा न होना (public comments की जगह अस्थायी निजी नोट्स के लिए)

    • एक रूपक के रूप में कहा गया कि Azure DevOps का मकसद Microsoft की marketing philosophy को GitHub में समाने से रोकने वाला एक "gravity well" जैसा है

    • यह भी इशारा किया गया कि login wall पहले से मौजूद है, और searchable issues की संख्या भी तेज़ी से सीमित की जा रही है, यानी openness घट रही है

  • federation न होना खलता है। इतने बड़े source repository का केंद्रीकरण पूरी developer community के लिए बचने लायक संरचना माना गया। GitLab के federated merge requests (संबंधित issue) feature पर 9 साल से कोई प्रगति नहीं। सिर्फ यही feature हो तो सभी लोग एक केंद्रीकृत system पर निर्भर हुए बिना git की तरह collaborate कर सकते हैं। साथ ही, हाल में Microsoft ने अमेरिकी प्रशासन के आदेश पर अंतरराष्ट्रीय अपराध न्यायालय के मुख्य अभियोजक का email account block कर दिया था, यह किस्सा भी साझा किया गया। यूरोपीय संघ के पक्ष में खड़े होने का प्रचार करने के कुछ ही समय बाद यह हुआ, इसलिए विडंबना और भी बढ़ गई। ट्रम्प को EU से सख्त आपत्ति है, और अगर कभी वह Microsoft से GitHub का EU access बंद करने को कहे तो यह संभव है। ऐसी स्थिति का business और open source पर क्या असर होगा, इस पर गंभीरता से सोचने की चेतावनी दी गई

    • यह मत कि सिर्फ चीन ही नहीं, अमेरिकी तकनीक की विश्वसनीयता भी अस्थिर हो गई है, इसलिए public institutions और governments को किसी एक देश की technology पर निर्भरता पर फिर से विचार करना चाहिए

    • Radicle जैसे विकल्प आज़माने की इच्छा जताई गई। अगर हालात और बिगड़ने का इंतज़ार करेंगे, तो बाद में पछताना पड़ सकता है

  • Obsidian से लगभग मिलता-जुलता, बस थोड़ा ज़्यादा process वाला लगा

    • मज़ाक में कहा गया कि उन processes में से एक यह भी हो सकता है: "सभी devices पर access के लिए सालाना $50 दो" या "web access के लिए सालाना $100 दो"

    • दरअसल Obsidian भी text files के ऊपर थोड़ी अतिरिक्त process जैसा ही है। लेकिन मूल रूप से text files खुद बहुत शक्तिशाली हैं, और devices के बीच sync करने के कई तरीके मौजूद हैं

    • Obsidian के विपरीत, GitHub Issues सिर्फ online है। अगर backup संभव नहीं है, तो यह निश्चित ही समस्या है

    • जिज्ञासा जताई गई कि क्या Obsidian को self-host किया जा सकता है। काम के लिए इस्तेमाल करते समय security की चिंता रहती है, इसलिए सब कुछ local में रखकर सिर्फ Markdown files को OneDrive से backup करने का तरीका सुझाया गया