Software Architecture Diagram कैसे बनाएं (2022)

 (terrastruct.com)
3 पॉइंट द्वारा GN⁺ 2023-10-28 | 1 टिप्पणियां | WhatsApp पर शेयर करें
  • प्रभावी software architecture diagram कैसे बनाएं, इस पर एक लेख
  • लेखक software development में diagrams के महत्व पर ज़ोर देते हैं; ये अक्सर चर्चा और decision-making का केंद्र बनते हैं
  • diagram की सामग्री सटीक, up-to-date और अस्पष्टता-रहित होनी चाहिए, और entities तथा relationships को सही ढंग से दर्शाना चाहिए
  • लेखक प्रभावी diagram की कई विशेषताएँ सुझाते हैं:
    • पड़ोसी दूरी को न्यूनतम करना: संबंधित nodes को एक-दूसरे के पास रखने से diagram को समझना आसान होता है। diagram जितना बड़ा होता है, यह उतना ही चुनौतीपूर्ण हो जाता है
    • समरूपता खोजना: सममित diagrams देखने में आकर्षक होते हैं और समझने में आसान होते हैं। साथ ही, ये diagram द्वारा संप्रेषित अर्थ को और मजबूत कर सकते हैं
    • केंद्र संरेखण: साफ़-सुथरे और aligned diagrams अवधारणाओं को स्पष्ट बनाते हैं। हर नई चीज़ जोड़ते समय alignment बनाए रखने से diagram व्यवस्थित रहता है
    • container groups का उपयोग: diagram को labels वाले कई क्षेत्रों में बाँटने से उसे समझना आसान हो जाता है। containers संदर्भ जोड़ सकते हैं, abstraction दिखा सकते हैं, या संबंधित objects को समूहित कर सकते हैं
  • लेखक वादा करते हैं कि भाग 2 में line routing, label के size और position, color, icons आदि पर और चर्चा की जाएगी
  • यह लेख Terrastruct blog का हिस्सा है, जो software engineers और developers के लिए संसाधन प्रदान करता है

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

1 टिप्पणियां

 
GN⁺ 2023-10-28
Hacker News की राय
  • एक उपयोगकर्ता D2 language के formatting options और syntax की वजह से diagram बनाना पसंद करता है, और उसने इस पर एक blog post लिखा।
  • VisualFlows.io जल्द ही v1.0 जारी करने वाला है, जिससे उपयोगकर्ता कुछ ही मिनटों में अपने SaaS का animated architecture map डिज़ाइन कर सकेंगे। इसकी मुख्य विशेषताओं में Smart Sections, Smart Edges, Smart Node Deletion, Dark/Light modes, Embeddable, Drag n Drop images/svgs/gifs, AWS/Windows/Google Icons, और Markdown support शामिल हैं।
  • एक अन्य उपयोगकर्ता का तर्क है कि जैसे ही system बदलना शुरू होता है, "सुंदर" diagram को बनाए रखना मुश्किल हो सकता है, और वह diagrams-as-code को एक अधिक कुशल विकल्प के रूप में इस्तेमाल करने का सुझाव देता है।
  • एक उपयोगकर्ता इस बात पर असंतोष जताता है कि जबकि large language models संभव हैं, blocks और arrows को फिर से व्यवस्थित करके सौंदर्यपूर्ण रूप देने के लिए local tools नहीं हैं। वह सवाल उठाता है कि ऐसा tool क्यों नहीं है जिसमें उपयोगकर्ता boxes और arrows बना सके, और tool सब कुछ align करके अच्छा दिखा दे।
  • एक उपयोगकर्ता software architecture diagrams, electrical schematics, circuit diagrams, और अन्य engineering drawings के बीच समानता बताता है। उसका कहना है कि कोई एक 'सही जवाब' नहीं होता, और अच्छी abstraction व presentation method चुनना ही पछतावे वाली अव्यवस्था और समझ में आने वाले विचारों के बीच फर्क करता है।
  • एक उपयोगकर्ता yEd का इस्तेमाल करके diagram बनाने का अपना अनुभव साझा करता है। उसके अनुसार इस tool में boxes और arrows बिखर सकते हैं, लेकिन menu में कुछ clicks से वे अपने-आप व्यवस्थित हो जाते हैं।
  • एक उपयोगकर्ता ऐसे लेख के लिए आभार व्यक्त करता है जो व्यावहारिक तरीके से बताता है कि किसी चीज़ को अधिक सुंदर कैसे बनाया जाए। वह आमतौर पर अपनी instinct पर निर्भर करता है।
  • एक उपयोगकर्ता serverless.yml फ़ाइल से बड़ा D2 diagram अपने-आप जनरेट करने के अपने अनुभव को साझा करता है। उसके अनुसार system के बढ़ने के साथ यह tool अपने-आप update होता रहता है।
  • एक अन्य उपयोगकर्ता cyber security design code पर अपने विषय को कवर करने के लिए अपनी blog post में D2 language जोड़ता है।
  • एक उपयोगकर्ता markdown documents में लिखे गए project में diagram शामिल करने के लिए plantuml blocks जोड़ने का सुझाव देता है। वह बताता है कि Gitlab में .md फ़ाइल को web browser में खोलने पर यह अच्छी तरह render होती है, लेकिन Github में अभी यह सुविधा नहीं है।