diff --git a/docs/CODE_OF_CONDUCT-kn.md b/docs/CODE_OF_CONDUCT-kn.md new file mode 100644 index 000000000..7dbf79575 --- /dev/null +++ b/docs/CODE_OF_CONDUCT-kn.md @@ -0,0 +1,32 @@ +# ನೀತಿ ಸಂಹಿತೆ + +ಈ ಯೋಜನೆಯ ಕೊಡುಗೆದಾರರು ಮತ್ತು ನಿರ್ವಾಹಕರ ಹಿತಾಸಕ್ತಿ ಮತ್ತು ಮುಕ್ತ ಮತ್ತು ಸ್ವಾಗತಾರ್ಹ ಸಮುದಾಯವನ್ನು ಬೆಳೆಸುವಾಗ, ಸಮಸ್ಯೆಗಳನ್ನು ವರದಿ ಮಾಡುವ ಮೂಲಕ, ವೈಶಿಷ್ಟ್ಯದ ವಿನಂತಿಗಳನ್ನು ಪೋಸ್ಟ್ ಮಾಡುವ ಮೂಲಕ, ದಸ್ತಾವೇಜನ್ನು ನವೀಕರಿಸುವ ಮೂಲಕ ಪುಲ್ ವಿನಂತಿಗಳು ಅಥವಾ ಪ್ಯಾಚ್‌ಗಳ ಸಲ್ಲಿಕೆ ಮತ್ತು ಇತರ ಚಟುವಟಿಕೆಗಳ ಮೂಲಕ ಕೊಡುಗೆ ನೀಡುವ ಪ್ರತಿಯೊಬ್ಬರನ್ನು ನಾವು ಗೌರವಿಸುತ್ತೇವೆ ಎಂದು ಪ್ರತಿಜ್ಞೆ ಮಾಡುತ್ತೇವೆ. +ಅನುಭವದ ಮಟ್ಟ, ಲಿಂಗ, ಲಿಂಗ ಗುರುತಿಸುವಿಕೆ ಮತ್ತು ಅಭಿವ್ಯಕ್ತಿ, ಲೈಂಗಿಕ ದೃಷ್ಟಿಕೋನ, ಅಂಗವೈಕಲ್ಯ, ವೈಯಕ್ತಿಕ ನೋಟ, ಏನೇ ಇರಲಿ, ಈ ಯೋಜನೆಯಲ್ಲಿ ಭಾಗವಹಿಸುವಿಕೆಯನ್ನು ಎಲ್ಲರಿಗೂ ಕಿರುಕುಳ-ಮುಕ್ತ ಅನುಭವವನ್ನಾಗಿ ಮಾಡಲು ನಾವು ಬದ್ಧರಾಗಿದ್ದೇವೆ. +ದೇಹದ ಗಾತ್ರ, ಜನಾಂಗ, ಜನಾಂಗ, ವಯಸ್ಸು, ಧರ್ಮ ಅಥವಾ ರಾಷ್ಟ್ರೀಯತೆ. + +ಭಾಗವಹಿಸುವವರ ಸ್ವೀಕಾರಾರ್ಹವಲ್ಲದ ನಡವಳಿಕೆಯ ಉದಾಹರಣೆಗಳು: + +* ಲೈಂಗಿಕ ಭಾಷೆ ಅಥವಾ ಚಿತ್ರಣದ ಬಳಕೆ +* ವೈಯಕ್ತಿಕ ದಾಳಿಗಳು +* ಟ್ರೋಲಿಂಗ್ ಅಥವಾ ಅವಹೇಳನಕಾರಿ/ ಅವಹೇಳನಕಾರಿ ಟೀಕೆಗಳು +* ಸಾರ್ವಜನಿಕ ಅಥವಾ ಖಾಸಗಿ ಕಿರುಕುಳ +* ಎಕ್ಸ್‌ಪ್ರೆಸ್ ಅನುಮತಿಯಿಲ್ಲದೆ ಭೌತಿಕ ಅಥವಾ ಎಲೆಕ್ಟ್ರಾನಿಕ್ ವಿಳಾಸಗಳಂತಹ ಇತರ ವೈಯಕ್ತಿಕ ಮಾಹಿತಿಯನ್ನು ಪ್ರಕಟಿಸುವುದು +* ಇತರ ಅನೈತಿಕ ಅಥವಾ ವೃತ್ತಿಪರವಲ್ಲದ ನಡವಳಿಕೆ + + +ಈ ನೀತಿ ಸಂಹಿತೆಯೊಂದಿಗೆ ಸಂಯೋಜಿತವಾಗಿಲ್ಲದ ಕಾಮೆಂಟ್‌ಗಳು, ಕೋಡ್, ವಿಕಿ ಸಂಪಾದನೆಗಳು, ಸಮಸ್ಯೆಗಳು ಮತ್ತು ಇತರ ಕೊಡುಗೆಗಳನ್ನು ತೆಗೆದುಹಾಕಲು, ಸಂಪಾದಿಸಲು ಅಥವಾ ಅನುಮತಿಸದಿರಲು ಅಥವಾ ಅವರು ಪರಿಗಣಿಸುವ ಇತರ ನಡವಳಿಕೆಗಳಿಗೆ ಯಾವುದೇ ಕೊಡುಗೆದಾರರನ್ನು ತಾತ್ಕಾಲಿಕವಾಗಿ ಅಥವಾ ಶಾಶ್ವತವಾಗಿ ನಿಷೇಧಿಸಲು ಪ್ರಾಜೆಕ್ಟ್ ನಿರ್ವಾಹಕರು ಹಕ್ಕು ಮತ್ತು ಬಾಧ್ಯತೆಯನ್ನು ಹೊಂದಿರುತ್ತಾರೆ. ಅನುಚಿತ, ಬೆದರಿಕೆ, ಆಕ್ಷೇಪಾರ್ಹ ಅಥವಾ ಹಾನಿಕಾರಕ. + +ಈ ನೀತಿ ಸಂಹಿತೆಯನ್ನು ಅಳವಡಿಸಿಕೊಳ್ಳುವ ಮೂಲಕ, ಯೋಜನಾ ನಿರ್ವಾಹಕರು ನಿರ್ವಹಣೆಯ ಪ್ರತಿಯೊಂದು ಅಂಶಕ್ಕೂ ಈ ತತ್ವಗಳ ಸರಿಯಾದ ಮತ್ತು ಸ್ಥಿರವಾದ ಅನ್ವಯಕ್ಕೆ ತಮ್ಮನ್ನು ತಾವು ತೊಡಗಿಸಿಕೊಳ್ಳುತ್ತಾರೆ. +ಈ ಯೋಜನೆ. ಕೋಡ್ ಅನ್ನು ಅನುಸರಿಸದ ಅಥವಾ ನಡವಳಿಕೆಯನ್ನು ಜಾರಿಗೊಳಿಸದ ಪ್ರಾಜೆಕ್ಟ್ ನಿರ್ವಾಹಕರನ್ನು ಪ್ರಾಜೆಕ್ಟ್ ತಂಡದಿಂದ ಶಾಶ್ವತವಾಗಿ ತೆಗೆದುಹಾಕಬಹುದು. + +ವ್ಯಕ್ತಿಯು ಪ್ರಾಜೆಕ್ಟ್ ಅಥವಾ ಅದರ ಸಮುದಾಯವನ್ನು ಪ್ರತಿನಿಧಿಸಿದಾಗ ಈ ನೀತಿ ಸಂಹಿತೆ ಯೋಜನೆಯೊಳಗೆ ಮತ್ತು ಸಾರ್ವಜನಿಕ ಸ್ಥಳಗಳಲ್ಲಿ ಅನ್ವಯಿಸುತ್ತದೆ. ನಿಂದನೀಯ, ಕಿರುಕುಳ ಅಥವಾ ಸ್ವೀಕಾರಾರ್ಹವಲ್ಲದ ನಡವಳಿಕೆಯ ಉದಾಹರಣೆಗಳು ಸಂಭವಿಸಬಹುದು +gmail.com ನಲ್ಲಿ victorfelder ನಲ್ಲಿ ಪ್ರಾಜೆಕ್ಟ್ ನಿರ್ವಾಹಕರನ್ನು ಸಂಪರ್ಕಿಸುವ ಮೂಲಕ ವರದಿ ಮಾಡಲಾಗಿದೆ. ಎಲ್ಲಾ ದೂರುಗಳನ್ನು ಪರಿಶೀಲಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ತನಿಖೆ ಮಾಡಲಾಗುತ್ತದೆ ಮತ್ತು ಪರಿಣಾಮವಾಗಿ ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಅಗತ್ಯ ಮತ್ತು ಸಂದರ್ಭಗಳಿಗೆ ಸೂಕ್ತವೆಂದು ಪರಿಗಣಿಸಲಾಗುತ್ತದೆ. ಕೀಪರ್ಗಳಾಗಿದ್ದಾರೆ +ಘಟನೆಯ ವರದಿಗಾರರಿಗೆ ಸಂಬಂಧಿಸಿದಂತೆ ಗೌಪ್ಯತೆಯನ್ನು ಕಾಪಾಡಿಕೊಳ್ಳಲು ನಿರ್ಬಂಧವನ್ನು ಹೊಂದಿರುತ್ತಾರೆ. + + +ಅವರ ನೀತಿ ಸಂಹಿತೆಯನ್ನು [ಕೊಡುಗೆದಾರರ ಒಡಂಬಡಿಕೆ] [ಮುಖಪುಟ], ಆವೃತ್ತಿ 1.3.0 ರಿಂದ ಅಳವಡಿಸಲಾಗಿದೆ, ಇಲ್ಲಿ ಲಭ್ಯವಿದೆ +https://contributor-covenant.org/version/1/3/0/ + +[ಮುಖಪುಟ]: https://contributor-covenant.org + +[ಅನುವಾದಗಳು](README.md#translations) \ No newline at end of file diff --git a/docs/CONTRIBUTING-kn.md b/docs/CONTRIBUTING-kn.md new file mode 100644 index 000000000..fb02fd597 --- /dev/null +++ b/docs/CONTRIBUTING-kn.md @@ -0,0 +1,232 @@ +## ಕೊಡುಗೆದಾರರ ಪರವಾನಗಿ ಒಪ್ಪಂದ + +ಈ ಯೋಜನೆಗೆ ಕೊಡುಗೆದಾರರು ರೆಪೊಸಿಟರಿಯ [ನಿಯಮಗಳು](../ಲೈಸೆನ್ಸ್) ಅನ್ನು ಒಪ್ಪುತ್ತಾರೆ ಎಂದು ಪರಿಗಣಿಸಲಾಗುತ್ತದೆ. + + +## ಕೊಡುಗೆದಾರರ ನೀತಿ ಸಂಹಿತೆ + +ಈ ಭಂಡಾರಕ್ಕೆ ಕೊಡುಗೆ ನೀಡುವ ಮೂಲಕ, ಎಲ್ಲಾ ಕೊಡುಗೆದಾರರು ಈ [ನಡತೆ ಸಂಹಿತೆ] (CODE_OF_CONDUCT-en.md) ಗೆ ಒಪ್ಪುತ್ತಾರೆ. ([ಅನುವಾದಗಳು](README.md#translations)) + + +## ಸಾರಾಂಶ + +1. "ಪುಸ್ತಕವನ್ನು ಸುಲಭವಾಗಿ ಡೌನ್‌ಲೋಡ್ ಮಾಡಲು ಶಾರ್ಟ್‌ಕಟ್" ಪುಸ್ತಕವು ಉಚಿತವಾಗಿದೆ ಎಂದು ಖಾತರಿಪಡಿಸುವುದಿಲ್ಲ. ಈ ಯೋಜನೆಗೆ ಕೊಡುಗೆ ನೀಡುವ ಮೊದಲು, ಶಾರ್ಟ್‌ಕಟ್ ಉಚಿತವಾಗಿದೆಯೇ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ. ಕಾರ್ಯನಿರ್ವಹಿಸುವ ಇಮೇಲ್ ಅಗತ್ಯವಿರುವ ಶಾರ್ಟ್‌ಕಟ್‌ಗಳನ್ನು ಸಹ ನಾವು ಸ್ವೀಕರಿಸುವುದಿಲ್ಲ, ಆದರೆ ಇಮೇಲ್ ಕೇಳುವವರಿಗೆ ನಾವು ಅವಕಾಶ ನೀಡುತ್ತೇವೆ. + +2. ನೀವು Git ಅನ್ನು ತಿಳಿದುಕೊಳ್ಳಬೇಕಾಗಿಲ್ಲ: ನೀವು ಮಾನದಂಡವನ್ನು ಪೂರೈಸುವ ಶಾರ್ಟ್‌ಕಟ್ ಅನ್ನು *ಈಗಾಗಲೇ ಪಟ್ಟಿ ಮಾಡಲಾಗಿಲ್ಲ* ಕಂಡುಬಂದರೆ, ನಂತರ ಹೊಸ [ಸಮಸ್ಯೆ] (https://github.com/EbookFoundation/free- programming-books/issues ) + - Git ಅನ್ನು ಹೇಗೆ ಬಳಸುವುದು ಎಂದು ನಿಮಗೆ ತಿಳಿದಿದ್ದರೆ, ರೆಪೊಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ ಮತ್ತು ಪುಲ್ ವಿನಂತಿಯನ್ನು (PR) ಕಳುಹಿಸಿ. + +3. ನಾವು ಆರು ರೀತಿಯ ಪಟ್ಟಿಗಳನ್ನು ಒದಗಿಸುತ್ತೇವೆ. ದಯವಿಟ್ಟು ಸರಿಯಾದದನ್ನು ಆಯ್ಕೆಮಾಡಿ: + + - *ಪುಸ್ತಕಗಳು*: PDF, HTML, ePub, gitbook.io ಆಧಾರಿತ ವೆಬ್‌ಸೈಟ್‌ಗಳು, git ರೆಪೊಸಿಟರಿಗಳು, ಇತ್ಯಾದಿ. + - *ಕೋರ್ಸ್*: ಇಲ್ಲಿ, ಕೋರ್ಸ್ ಒಂದು ಶೈಕ್ಷಣಿಕ ಸಾಧನವನ್ನು ಸೂಚಿಸುತ್ತದೆ, ಪುಸ್ತಕವಲ್ಲ. [ಉದಾಹರಣೆ ಕೋರ್ಸ್] (http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). + - *ಇಂಟರಾಕ್ಟಿವ್ ಕೋರ್ಸ್*: ಬಳಕೆದಾರರು ಕೋಡ್ ಅನ್ನು ನಮೂದಿಸಬಹುದಾದ ವೆಬ್‌ಸೈಟ್ ಅಥವಾ ಮೌಲ್ಯಮಾಪನ ಮಾಡಲು ಆದೇಶವನ್ನು ನಮೂದಿಸಬಹುದು (ಮೌಲ್ಯಮಾಪನವು ಗ್ರೇಡಿಂಗ್ ಅಲ್ಲ). ಉದಾಹರಣೆಗಳು: [ಹ್ಯಾಸ್ಕೆಲ್ ಪ್ರಯತ್ನಿಸಿ] (http://tryhaskell.org), [GitHub ಪ್ರಯತ್ನಿಸಿ] (http://try.github.io). + - *ಆಟದ ಮೈದಾನಗಳು* : ಪ್ರೋಗ್ರಾಮಿಂಗ್ ಕಲಿಯಲು ಆನ್‌ಲೈನ್ ಮತ್ತು ಸಂವಾದಾತ್ಮಕ ವೆಬ್‌ಸೈಟ್‌ಗಳು, ಆಟಗಳು ಅಥವಾ ಡೆಸ್ಕ್‌ಟಾಪ್ ಸಾಫ್ಟ್‌ವೇರ್. ಕೋಡ್ ತುಣುಕುಗಳನ್ನು ಬರೆಯಿರಿ, ಕಂಪೈಲ್ ಮಾಡಿ (ಅಥವಾ ರನ್ ಮಾಡಿ) ಮತ್ತು ಹಂಚಿಕೊಳ್ಳಿ. ಆಟದ ಮೈದಾನಗಳು ಸಾಮಾನ್ಯವಾಗಿ ಕೋಡ್‌ನೊಂದಿಗೆ ಆಡುವ ಮೂಲಕ ನಿಮ್ಮ ಕೈಗಳನ್ನು ಫೋರ್ಕ್ ಮಾಡಲು ಮತ್ತು ಕೊಳಕು ಮಾಡಲು ಅನುಮತಿಸುತ್ತದೆ. + - *ಪಾಡ್‌ಕ್ಯಾಸ್ಟ್ ಮತ್ತು ಸ್ಕ್ರೀನ್ ರೆಕಾರ್ಡಿಂಗ್* + - *ಸಮಸ್ಯೆ ಪುಸ್ತಕ ಮತ್ತು ಸ್ಪರ್ಧಾತ್ಮಕ ಪ್ರೋಗ್ರಾಮಿಂಗ್*: ಇದು ಸಮಸ್ಯೆಗಳನ್ನು ಪರಿಹರಿಸುವ ಮೂಲಕ ಪ್ರೋಗ್ರಾಮಿಂಗ್ ಕೌಶಲ್ಯಗಳನ್ನು ಸುಧಾರಿಸಲು ಸಹಾಯ ಮಾಡುವ ಸಾಫ್ಟ್‌ವೇರ್ ಅಥವಾ ವೆಬ್‌ಸೈಟ್‌ಗಳನ್ನು ಉಲ್ಲೇಖಿಸುತ್ತದೆ. ಅಂತಹ ಸಾಫ್ಟ್‌ವೇರ್ ಅಥವಾ ವೆಬ್‌ಸೈಟ್‌ಗಳು ಪೀರ್-ನಿರ್ದೇಶಿತ ಕೋಡ್ ವಿಮರ್ಶೆಗಳನ್ನು ಒಳಗೊಂಡಿರಬಹುದು. + +4. ಕೆಳಗಿನ [ಮಾರ್ಗಸೂಚಿ] (#ಮಾರ್ಗಸೂಚಿ) ಅನ್ನು ನೋಡಿ ಮತ್ತು [ಮಾರ್ಕ್‌ಡೌನ್ ಮಾನದಂಡ] (#ಸ್ಟ್ಯಾಂಡರ್ಡ್) ಅನ್ನು ಅನುಸರಿಸಿ. + +5. GitHub ಕ್ರಿಯೆಗಳು ಪ್ರತಿ **ಪಟ್ಟಿಯು ಆರೋಹಣ** ಕ್ರಮದಲ್ಲಿದೆಯೇ ಎಂಬುದನ್ನು ಪರಿಶೀಲಿಸುತ್ತದೆ ಮತ್ತು **ಮಾರ್ಕ್‌ಡೌನ್ ವಿಶೇಷಣಗಳನ್ನು ಅನುಸರಿಸಲಾಗಿದೆ**. ಪ್ರತಿ ಸಲ್ಲಿಕೆ** ತಪಾಸಣೆಯನ್ನು ಹಾದುಹೋಗುತ್ತದೆಯೇ ಎಂಬುದನ್ನು ದಯವಿಟ್ಟು ** ಪರಿಶೀಲಿಸಿ. + + +### ಮಾರ್ಗಸೂಚಿ + +- ಪುಸ್ತಕವು ಉಚಿತವಾಗಿದೆಯೇ ಎಂದು ಪರೀಕ್ಷಿಸಲು ಮರೆಯದಿರಿ. ಪುಸ್ತಕವು ಉಚಿತವಾಗಿದೆ ಎಂದು ಅವರು ಏಕೆ ಭಾವಿಸುತ್ತಾರೆ ಎಂಬುದನ್ನು PR ಕಾಮೆಂಟ್‌ಗಳಲ್ಲಿ ಸೇರಿಸಲು ನಿರ್ವಾಹಕರಿಗೆ ಇದು ಉತ್ತಮ ಸಹಾಯವಾಗಿದೆ. +- ನಾವು Google Drive, Dropbox, Mega, Scribd, Issuu ಅಥವಾ ಅಂತಹುದೇ ಫೈಲ್ ಹಂಚಿಕೆ ವ್ಯವಸ್ಥೆಗಳಿಗೆ ಅಪ್‌ಲೋಡ್ ಮಾಡಿದ ಫೈಲ್‌ಗಳನ್ನು ಸ್ವೀಕರಿಸುವುದಿಲ್ಲ. +- ಶಾರ್ಟ್‌ಕಟ್‌ಗಳನ್ನು ಆರೋಹಣ ಕ್ರಮದಲ್ಲಿ ವಿಂಗಡಿಸಿ, ವಿವರಿಸಿದಂತೆ [ಕೆಳಗೆ](#ವರ್ಣಮಾಲೆ-ಕ್ರಮ). +- ಸಾಧ್ಯವಾದಷ್ಟು ಮೂಲ ಲೇಖಕರಿಗೆ ಹತ್ತಿರವಿರುವ ಶಾರ್ಟ್‌ಕಟ್ ಅನ್ನು ಬಳಸಿ (ಲೇಖಕರ ವೆಬ್‌ಸೈಟ್ ಸಂಪಾದಕರ ವೆಬ್‌ಸೈಟ್‌ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ ಮತ್ತು ಸಂಪಾದಕರ ಮೂರನೇ ವ್ಯಕ್ತಿಯ ವೆಬ್‌ಸೈಟ್‌ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ). +- ಅವರು ಒಂದೇ ವಿಷಯವನ್ನು ಒಳಗೊಂಡಿರುವ ಪ್ರಮೇಯದಲ್ಲಿ `http` ವಿಳಾಸಕ್ಕಿಂತ `https` ವಿಳಾಸಕ್ಕೆ ಆದ್ಯತೆ ನೀಡಿ. +- ರೂಟ್ ಡೊಮೇನ್ ಅನ್ನು ಬಳಸುವಾಗ, ದಯವಿಟ್ಟು ಕೊನೆಯಲ್ಲಿ / ಅನ್ನು ಹೊರತುಪಡಿಸಿ. (`http://example.com` `http://example.com/` ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ) +- ಎಲ್ಲಾ ಸಂದರ್ಭಗಳಲ್ಲಿ ಚಿಕ್ಕ ಲಿಂಕ್‌ಗಳಿಗೆ ಆದ್ಯತೆ ನೀಡಿ: `http://example.com/dir/` `http://example.com/dir/index.html` ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ, ಆದರೆ URL ಬಟನ್ ಸೇವೆಯನ್ನು ಬಳಸಬೇಡಿ. +- ಹೆಚ್ಚಿನ ಸಂದರ್ಭಗಳಲ್ಲಿ ಆವೃತ್ತಿಯ ವೆಬ್‌ಸೈಟ್‌ಗಿಂತ ವೆಬ್‌ಸೈಟ್‌ನ ಪ್ರಸ್ತುತ ಆವೃತ್ತಿಯನ್ನು ಆದ್ಯತೆ ನೀಡಿ (`http://example.com/dir/book/current/` ಎಂಬುದು `http://example.com/dir/book/v1' ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ .0.0/index.html`) +- ಶಾರ್ಟ್‌ಕಟ್‌ನ ಪ್ರಮಾಣಪತ್ರದ ಅವಧಿ ಮುಗಿದಿದ್ದರೆ: + 1. `http` ಫಾರ್ಮ್ಯಾಟ್‌ನೊಂದಿಗೆ *ಬದಲಿ* ಮಾಡಿ + 2. `http` ಆವೃತ್ತಿಯು ಅಸ್ತಿತ್ವದಲ್ಲಿಲ್ಲದಿದ್ದರೆ, ಅಸ್ತಿತ್ವದಲ್ಲಿರುವ ಲಿಂಕ್ ಅನ್ನು ಬಳಸಿ. ನೀವು ವಿನಾಯಿತಿಯನ್ನು ಸೇರಿಸಿದರೆ `https` ಸ್ವರೂಪವನ್ನು ಸಹ ಬಳಸಬಹುದು. + 3. *ಹೊರತುಪಡಿಸು* +- ಶಾರ್ಟ್‌ಕಟ್ ಬಹು ಸ್ವರೂಪಗಳಲ್ಲಿ ಅಸ್ತಿತ್ವದಲ್ಲಿದ್ದರೆ, ದಯವಿಟ್ಟು ಪ್ರತಿಯೊಂದನ್ನು ಟಿಪ್ಪಣಿಯೊಂದಿಗೆ ಲಗತ್ತಿಸಿ. +- ವಸ್ತುವು ಬಹು ಸೈಟ್‌ಗಳಲ್ಲಿ ಹರಡಿದ್ದರೆ, ಅತ್ಯಂತ ವಿಶ್ವಾಸಾರ್ಹ ಶಾರ್ಟ್‌ಕಟ್ ಅನ್ನು ಲಗತ್ತಿಸಿ. ಪ್ರತಿಯೊಂದು ಶಾರ್ಟ್‌ಕಟ್ ಬೇರೆಯ ಆವೃತ್ತಿಯನ್ನು ಸೂಚಿಸಿದರೆ, ಅವೆಲ್ಲವನ್ನೂ ಟಿಪ್ಪಣಿಯೊಂದಿಗೆ ಸೇರಿಸಿ. (ಗಮನಿಸಿ: [ಸಂಚಿಕೆ #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) ಈ ಲೇಖನವು ನಿರ್ದಿಷ್ಟತೆಯನ್ನು ವಿವರಿಸುತ್ತದೆ). +- ದೊಡ್ಡ ಪ್ರಮಾಣದ ವಸ್ತುಗಳೊಂದಿಗೆ ಏಕ ಕಮಿಟ್‌ಗಳಿಗಿಂತ ಸಣ್ಣ ಬದಲಾವಣೆಗಳೊಂದಿಗೆ ಬಹು ಕಮಿಟ್‌ಗಳಿಗೆ ಆದ್ಯತೆ ನೀಡಲಾಗುತ್ತದೆ. +- ಇದು ಹಳೆಯ ಪುಸ್ತಕವಾಗಿದ್ದರೆ, ಶೀರ್ಷಿಕೆಯೊಂದಿಗೆ ಪ್ರಕಟಣೆಯ ದಿನಾಂಕವನ್ನು ಸೇರಿಸಿ. +- ದಯವಿಟ್ಟು ಲೇಖಕರ ಹೆಸರನ್ನು ನಿರ್ದಿಷ್ಟಪಡಿಸಿ. ನೀವು ಅದನ್ನು "`et al.`" ಬಳಸಿ ಕಡಿಮೆ ಮಾಡಬಹುದು. +- ಪುಸ್ತಕವು ಇನ್ನೂ ಪೂರ್ಣವಾಗಿಲ್ಲದಿದ್ದರೆ, [ಕೆಳಗೆ] (#ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ_ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ) ನಿರ್ದಿಷ್ಟಪಡಿಸಿದಂತೆ "`ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ" ಗುರುತು ಸೇರಿಸಿ. +- [*ಇಂಟರ್ನೆಟ್ ಆರ್ಕೈವ್ಸ್ ವೇಬ್ಯಾಕ್ ಮೆಷಿನ್*](https://web.archive.org) (ಅಥವಾ ಇದೇ ರೀತಿಯ) ಬಳಸಿಕೊಂಡು ಸಂಪನ್ಮೂಲವನ್ನು ಮರುಸ್ಥಾಪಿಸಿದರೆ, ವಿವರಿಸಿದಂತೆ "`ಆರ್ಕೈವ್ಡ್`" ಸಂಕೇತವನ್ನು ಸೇರಿಸಿ [ಕೆಳಗೆ](#ಆರ್ಕೈವ್ ಮಾಡಲಾಗಿದೆ) . ಬಳಸಲು ಉತ್ತಮ ಆವೃತ್ತಿಗಳು ಇತ್ತೀಚಿನವು ಮತ್ತು ಸಂಪೂರ್ಣವಾಗಿವೆ. +- ಡೌನ್‌ಲೋಡ್ ಮಾಡುವ ಮೊದಲು ಇಮೇಲ್ ವಿಳಾಸ ಅಥವಾ ಖಾತೆ ರಚನೆಯನ್ನು ವಿನಂತಿಸಿದರೆ, ದಯವಿಟ್ಟು ಪ್ರತ್ಯೇಕ ಟಿಪ್ಪಣಿಯನ್ನು ಲಗತ್ತಿಸಿ. ಉದಾಹರಣೆ: `(ಇಮೇಲ್ ವಿಳಾಸ *ವಿನಂತಿಸಲಾಗಿದೆ*, ಅಗತ್ಯವಿಲ್ಲ)`. + + +### ಮಾನದಂಡ + +- ಎಲ್ಲಾ ಪಟ್ಟಿಗಳು `.md` ಫೈಲ್ ಫಾರ್ಮ್ಯಾಟ್‌ನಲ್ಲಿರಬೇಕು. ಆ ಫಾರ್ಮ್‌ಗೆ ಸಿಂಟ್ಯಾಕ್ಸ್ ಸರಳವಾಗಿದೆ ಮತ್ತು ಇದನ್ನು [Markdown] (https://guides.github.com/features/mastering-markdown/) ನಲ್ಲಿ ಕಾಣಬಹುದು. +- ಪ್ರತಿಯೊಂದು ಪಟ್ಟಿಯು ಪರಿವಿಡಿಯೊಂದಿಗೆ ಪ್ರಾರಂಭವಾಗಬೇಕು. ಪ್ರತಿಯೊಂದು ವಿಷಯವನ್ನು ಪರಿವಿಡಿಗೆ ಲಿಂಕ್ ಮಾಡುವುದು ಗುರಿಯಾಗಿದೆ. ಇದನ್ನು ಆರೋಹಣ ಕ್ರಮದಲ್ಲಿ ವಿಂಗಡಿಸಬೇಕು. +- ಪ್ರತಿಯೊಂದು ವಿಭಾಗವು ಮೂರು ಹಂತದ ಶಿರೋನಾಮೆಯನ್ನು ಬಳಸುತ್ತದೆ (`###`). ಉಪವಿಭಾಗಗಳು ನಾಲ್ಕು ಹಂತದ ಶೀರ್ಷಿಕೆಗಳನ್ನು ಬಳಸುತ್ತವೆ (`####`). + +ಒಳಗೊಂಡಿರಬೇಕು: + +- ಕೊನೆಯ ಶಾರ್ಟ್‌ಕಟ್ ಮತ್ತು ಹೊಸ ವಿಭಾಗದ ನಡುವೆ ಲೈನ್ ಬ್ರೇಕ್ '2' +- ಹೆಡರ್ ಮತ್ತು ವಿಭಾಗದ ಮೊದಲ ಶಾರ್ಟ್‌ಕಟ್ ನಡುವೆ ಲೈನ್ ಬ್ರೇಕ್ '1' +- ಎರಡು ಶಾರ್ಟ್‌ಕಟ್‌ಗಳ ನಡುವೆ ಲೈನ್ ಬ್ರೇಕ್ '0' +- `.md` ಫೈಲ್‌ನ ಕೊನೆಯಲ್ಲಿ `1` ಲೈನ್ ಬ್ರೇಕ್ + +ಉದಾಹರಣೆ: + +```ಪಠ್ಯ +[...] +* [ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/example.html) + (ಖಾಲಿ ಸಾಲು) + (ಖಾಲಿ ಸಾಲು) +### ಉದಾಹರಣೆ + (ಖಾಲಿ ಸಾಲು) +* [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) +* [ಕೆಲವು ಇತರ ಪುಸ್ತಕ] (http://example.com/other.html) +``` + +- `]` ಮತ್ತು `(`: ನಡುವೆ ಜಾಗವನ್ನು ಹಾಕಬೇಡಿ: + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) + ಒಳ್ಳೆಯದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) + ``` + +- ಲೇಖಕರನ್ನು ಸೂಚಿಸಲು, ಬಳಸಿ ` - ` (ಸ್ಪೇಸ್ - ಸ್ಪೇಸ್): + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) - ಜಾನ್ ಡೋ + ಒಳ್ಳೆಯದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) - ಜಾನ್ ಡೋ + ``` + +- ಶಾರ್ಟ್‌ಕಟ್ ಮತ್ತು ಫಾರ್ಮ್ಯಾಟ್ ನಡುವೆ ಜಾಗವನ್ನು ಸೇರಿಸಿ: + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಬಹಳ ಅದ್ಭುತ ಪುಸ್ತಕ] (https://example.org/book.pdf) (PDF) + ಒಳ್ಳೆಯದು: * [ಬಹಳ ಅದ್ಭುತ ಪುಸ್ತಕ] (https://example.org/book.pdf) (PDF) + ``` + +- ಲೇಖಕರು ರೂಪದಿಂದ ಮುಂಚಿತವಾಗಿರುತ್ತಾರೆ: + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಅತ್ಯಂತ ಅದ್ಭುತ ಪುಸ್ತಕ] (https://example.org/book.pdf)- (PDF) ಜೇನ್ ರೋ + ಒಳ್ಳೆಯದು: * [ಬಹಳ ಅದ್ಭುತ ಪುಸ್ತಕ] (https://example.org/book.pdf) - ಜೇನ್ ರೋ (PDF) + ``` + +- ಬಹು ಫೈಲ್ ಪ್ರಕಾರಗಳು ಅಸ್ತಿತ್ವದಲ್ಲಿದ್ದಾಗ: + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/) - ಜಾನ್ ಡೋ (HTML) + ಕೆಟ್ಟ: * [ಮತ್ತೊಂದು ಅದ್ಭುತ + + *[ಈ ಡಾಕ್ಯುಮೆಂಟ್ ಅನ್ನು ಇನ್ನೊಂದು ಭಾಷೆಯಲ್ಲಿ ವೀಕ್ಷಿಸಲು](README.md#translations)* + + +## ಕೊಡುಗೆದಾರರ ಪರವಾನಗಿ ಒಪ್ಪಂದ + +ಈ ಯೋಜನೆಗೆ ಕೊಡುಗೆದಾರರು ರೆಪೊಸಿಟರಿಯ [ನಿಯಮಗಳು](../ಲೈಸೆನ್ಸ್) ಅನ್ನು ಒಪ್ಪುತ್ತಾರೆ ಎಂದು ಪರಿಗಣಿಸಲಾಗುತ್ತದೆ. + + +## ಕೊಡುಗೆದಾರರ ನೀತಿ ಸಂಹಿತೆ + +ಈ ಭಂಡಾರಕ್ಕೆ ಕೊಡುಗೆ ನೀಡುವ ಮೂಲಕ, ಎಲ್ಲಾ ಕೊಡುಗೆದಾರರು ಈ [ನಡತೆ ಸಂಹಿತೆ] (CODE_OF_CONDUCT-en.md) ಗೆ ಒಪ್ಪುತ್ತಾರೆ. ([ಅನುವಾದಗಳು](README.md#translations)) + + +## ಸಾರಾಂಶ + +1. "ಪುಸ್ತಕವನ್ನು ಸುಲಭವಾಗಿ ಡೌನ್‌ಲೋಡ್ ಮಾಡಲು ಶಾರ್ಟ್‌ಕಟ್" ಪುಸ್ತಕವು ಉಚಿತವಾಗಿದೆ ಎಂದು ಖಾತರಿಪಡಿಸುವುದಿಲ್ಲ. ಈ ಯೋಜನೆಗೆ ಕೊಡುಗೆ ನೀಡುವ ಮೊದಲು, ಶಾರ್ಟ್‌ಕಟ್ ಉಚಿತವಾಗಿದೆಯೇ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ. ಕಾರ್ಯನಿರ್ವಹಿಸುವ ಇಮೇಲ್ ಅಗತ್ಯವಿರುವ ಶಾರ್ಟ್‌ಕಟ್‌ಗಳನ್ನು ಸಹ ನಾವು ಸ್ವೀಕರಿಸುವುದಿಲ್ಲ, ಆದರೆ ಇಮೇಲ್ ಕೇಳುವವರಿಗೆ ನಾವು ಅವಕಾಶ ನೀಡುತ್ತೇವೆ. + +2. ನೀವು Git ಅನ್ನು ತಿಳಿದುಕೊಳ್ಳಬೇಕಾಗಿಲ್ಲ: ನೀವು ಮಾನದಂಡವನ್ನು ಪೂರೈಸುವ ಶಾರ್ಟ್‌ಕಟ್ ಅನ್ನು *ಈಗಾಗಲೇ ಪಟ್ಟಿ ಮಾಡಲಾಗಿಲ್ಲ* ಕಂಡುಬಂದರೆ, ನಂತರ ಹೊಸ [ಸಮಸ್ಯೆ] (https://github.com/EbookFoundation/free- programming-books/issues ) + - Git ಅನ್ನು ಹೇಗೆ ಬಳಸುವುದು ಎಂದು ನಿಮಗೆ ತಿಳಿದಿದ್ದರೆ, ರೆಪೊಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ ಮತ್ತು ಪುಲ್ ವಿನಂತಿಯನ್ನು (PR) ಕಳುಹಿಸಿ. + +3. ನಾವು ಆರು ರೀತಿಯ ಪಟ್ಟಿಗಳನ್ನು ಒದಗಿಸುತ್ತೇವೆ. ದಯವಿಟ್ಟು ಸರಿಯಾದದನ್ನು ಆಯ್ಕೆಮಾಡಿ: + + - *ಪುಸ್ತಕಗಳು*: PDF, HTML, ePub, gitbook.io ಆಧಾರಿತ ವೆಬ್‌ಸೈಟ್‌ಗಳು, git ರೆಪೊಸಿಟರಿಗಳು, ಇತ್ಯಾದಿ. + - *ಕೋರ್ಸ್*: ಇಲ್ಲಿ, ಕೋರ್ಸ್ ಒಂದು ಶೈಕ್ಷಣಿಕ ಸಾಧನವನ್ನು ಸೂಚಿಸುತ್ತದೆ, ಪುಸ್ತಕವಲ್ಲ. [ಉದಾಹರಣೆ ಕೋರ್ಸ್] (http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). + - *ಇಂಟರಾಕ್ಟಿವ್ ಕೋರ್ಸ್*: ಬಳಕೆದಾರರು ಕೋಡ್ ಅನ್ನು ನಮೂದಿಸಬಹುದಾದ ವೆಬ್‌ಸೈಟ್ ಅಥವಾ ಮೌಲ್ಯಮಾಪನ ಮಾಡಲು ಆದೇಶವನ್ನು ನಮೂದಿಸಬಹುದು (ಮೌಲ್ಯಮಾಪನವು ಗ್ರೇಡಿಂಗ್ ಅಲ್ಲ). ಉದಾಹರಣೆಗಳು: [ಹ್ಯಾಸ್ಕೆಲ್ ಪ್ರಯತ್ನಿಸಿ] (http://tryhaskell.org), [GitHub ಪ್ರಯತ್ನಿಸಿ] (http://try.github.io). + - *ಆಟದ ಮೈದಾನಗಳು* : ಪ್ರೋಗ್ರಾಮಿಂಗ್ ಕಲಿಯಲು ಆನ್‌ಲೈನ್ ಮತ್ತು ಸಂವಾದಾತ್ಮಕ ವೆಬ್‌ಸೈಟ್‌ಗಳು, ಆಟಗಳು ಅಥವಾ ಡೆಸ್ಕ್‌ಟಾಪ್ ಸಾಫ್ಟ್‌ವೇರ್. ಕೋಡ್ ತುಣುಕುಗಳನ್ನು ಬರೆಯಿರಿ, ಕಂಪೈಲ್ ಮಾಡಿ (ಅಥವಾ ರನ್ ಮಾಡಿ) ಮತ್ತು ಹಂಚಿಕೊಳ್ಳಿ. ಆಟದ ಮೈದಾನಗಳು ಸಾಮಾನ್ಯವಾಗಿ ಕೋಡ್‌ನೊಂದಿಗೆ ಆಡುವ ಮೂಲಕ ನಿಮ್ಮ ಕೈಗಳನ್ನು ಫೋರ್ಕ್ ಮಾಡಲು ಮತ್ತು ಕೊಳಕು ಮಾಡಲು ಅನುಮತಿಸುತ್ತದೆ. + - *ಪಾಡ್‌ಕ್ಯಾಸ್ಟ್ ಮತ್ತು ಸ್ಕ್ರೀನ್ ರೆಕಾರ್ಡಿಂಗ್* + - *ಸಮಸ್ಯೆ ಪುಸ್ತಕ ಮತ್ತು ಸ್ಪರ್ಧಾತ್ಮಕ ಪ್ರೋಗ್ರಾಮಿಂಗ್*: ಇದು ಸಮಸ್ಯೆಗಳನ್ನು ಪರಿಹರಿಸುವ ಮೂಲಕ ಪ್ರೋಗ್ರಾಮಿಂಗ್ ಕೌಶಲ್ಯಗಳನ್ನು ಸುಧಾರಿಸಲು ಸಹಾಯ ಮಾಡುವ ಸಾಫ್ಟ್‌ವೇರ್ ಅಥವಾ ವೆಬ್‌ಸೈಟ್‌ಗಳನ್ನು ಉಲ್ಲೇಖಿಸುತ್ತದೆ. ಅಂತಹ ಸಾಫ್ಟ್‌ವೇರ್ ಅಥವಾ ವೆಬ್‌ಸೈಟ್‌ಗಳು ಪೀರ್-ನಿರ್ದೇಶಿತ ಕೋಡ್ ವಿಮರ್ಶೆಗಳನ್ನು ಒಳಗೊಂಡಿರಬಹುದು. + +4. ಕೆಳಗಿನ [ಮಾರ್ಗಸೂಚಿ] (#ಮಾರ್ಗಸೂಚಿ) ಅನ್ನು ನೋಡಿ ಮತ್ತು [ಮಾರ್ಕ್‌ಡೌನ್ ಮಾನದಂಡ] (#ಸ್ಟ್ಯಾಂಡರ್ಡ್) ಅನ್ನು ಅನುಸರಿಸಿ. + +5. GitHub ಕ್ರಿಯೆಗಳು ಪ್ರತಿ **ಪಟ್ಟಿಯು ಆರೋಹಣ** ಕ್ರಮದಲ್ಲಿದೆಯೇ ಎಂಬುದನ್ನು ಪರಿಶೀಲಿಸುತ್ತದೆ ಮತ್ತು **ಮಾರ್ಕ್‌ಡೌನ್ ವಿಶೇಷಣಗಳನ್ನು ಅನುಸರಿಸಲಾಗಿದೆ**. ಪ್ರತಿ ಸಲ್ಲಿಕೆ** ತಪಾಸಣೆಯನ್ನು ಹಾದುಹೋಗುತ್ತದೆಯೇ ಎಂಬುದನ್ನು ದಯವಿಟ್ಟು ** ಪರಿಶೀಲಿಸಿ. + + +### ಮಾರ್ಗಸೂಚಿ + +- ಪುಸ್ತಕವು ಉಚಿತವಾಗಿದೆಯೇ ಎಂದು ಪರೀಕ್ಷಿಸಲು ಮರೆಯದಿರಿ. ಪುಸ್ತಕವು ಉಚಿತವಾಗಿದೆ ಎಂದು ಅವರು ಏಕೆ ಭಾವಿಸುತ್ತಾರೆ ಎಂಬುದನ್ನು PR ಕಾಮೆಂಟ್‌ಗಳಲ್ಲಿ ಸೇರಿಸಲು ನಿರ್ವಾಹಕರಿಗೆ ಇದು ಉತ್ತಮ ಸಹಾಯವಾಗಿದೆ. +- ನಾವು Google Drive, Dropbox, Mega, Scribd, Issuu ಅಥವಾ ಅಂತಹುದೇ ಫೈಲ್ ಹಂಚಿಕೆ ವ್ಯವಸ್ಥೆಗಳಿಗೆ ಅಪ್‌ಲೋಡ್ ಮಾಡಿದ ಫೈಲ್‌ಗಳನ್ನು ಸ್ವೀಕರಿಸುವುದಿಲ್ಲ. +- ಶಾರ್ಟ್‌ಕಟ್‌ಗಳನ್ನು ಆರೋಹಣ ಕ್ರಮದಲ್ಲಿ ವಿಂಗಡಿಸಿ, ವಿವರಿಸಿದಂತೆ [ಕೆಳಗೆ](#ವರ್ಣಮಾಲೆ-ಕ್ರಮ). +- ಸಾಧ್ಯವಾದಷ್ಟು ಮೂಲ ಲೇಖಕರಿಗೆ ಹತ್ತಿರವಿರುವ ಶಾರ್ಟ್‌ಕಟ್ ಅನ್ನು ಬಳಸಿ (ಲೇಖಕರ ವೆಬ್‌ಸೈಟ್ ಸಂಪಾದಕರ ವೆಬ್‌ಸೈಟ್‌ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ ಮತ್ತು ಸಂಪಾದಕರ ಮೂರನೇ ವ್ಯಕ್ತಿಯ ವೆಬ್‌ಸೈಟ್‌ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ). +- ಅವರು ಒಂದೇ ವಿಷಯವನ್ನು ಒಳಗೊಂಡಿರುವ ಪ್ರಮೇಯದಲ್ಲಿ `http` ವಿಳಾಸಕ್ಕಿಂತ `https` ವಿಳಾಸಕ್ಕೆ ಆದ್ಯತೆ ನೀಡಿ. +- ರೂಟ್ ಡೊಮೇನ್ ಅನ್ನು ಬಳಸುವಾಗ, ದಯವಿಟ್ಟು ಕೊನೆಯಲ್ಲಿ / ಅನ್ನು ಹೊರತುಪಡಿಸಿ. (`http://example.com` `http://example.com/` ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ) +- ಎಲ್ಲಾ ಸಂದರ್ಭಗಳಲ್ಲಿ ಚಿಕ್ಕ ಲಿಂಕ್‌ಗಳಿಗೆ ಆದ್ಯತೆ ನೀಡಿ: `http://example.com/dir/` `http://example.com/dir/index.html` ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ, ಆದರೆ URL ಬಟನ್ ಸೇವೆಯನ್ನು ಬಳಸಬೇಡಿ. +- ಹೆಚ್ಚಿನ ಸಂದರ್ಭಗಳಲ್ಲಿ ಆವೃತ್ತಿಯ ವೆಬ್‌ಸೈಟ್‌ಗಿಂತ ವೆಬ್‌ಸೈಟ್‌ನ ಪ್ರಸ್ತುತ ಆವೃತ್ತಿಯನ್ನು ಆದ್ಯತೆ ನೀಡಿ (`http://example.com/dir/book/current/` ಎಂಬುದು `http://example.com/dir/book/v1' ಗಿಂತ ಉತ್ತಮವಾಗಿದೆ .0.0/index.html`) +- ಶಾರ್ಟ್‌ಕಟ್‌ನ ಪ್ರಮಾಣಪತ್ರದ ಅವಧಿ ಮುಗಿದಿದ್ದರೆ: + 1. `http` ಫಾರ್ಮ್ಯಾಟ್‌ನೊಂದಿಗೆ *ಬದಲಿ* ಮಾಡಿ + 2. `http` ಆವೃತ್ತಿಯು ಅಸ್ತಿತ್ವದಲ್ಲಿಲ್ಲದಿದ್ದರೆ, ಅಸ್ತಿತ್ವದಲ್ಲಿರುವ ಲಿಂಕ್ ಅನ್ನು ಬಳಸಿ. ನೀವು ವಿನಾಯಿತಿಯನ್ನು ಸೇರಿಸಿದರೆ `https` ಸ್ವರೂಪವನ್ನು ಸಹ ಬಳಸಬಹುದು. + 3. *ಹೊರತುಪಡಿಸು* +- ಶಾರ್ಟ್‌ಕಟ್ ಬಹು ಸ್ವರೂಪಗಳಲ್ಲಿ ಅಸ್ತಿತ್ವದಲ್ಲಿದ್ದರೆ, ದಯವಿಟ್ಟು ಪ್ರತಿಯೊಂದನ್ನು ಟಿಪ್ಪಣಿಯೊಂದಿಗೆ ಲಗತ್ತಿಸಿ. +- ವಸ್ತುವು ಬಹು ಸೈಟ್‌ಗಳಲ್ಲಿ ಹರಡಿದ್ದರೆ, ಅತ್ಯಂತ ವಿಶ್ವಾಸಾರ್ಹ ಶಾರ್ಟ್‌ಕಟ್ ಅನ್ನು ಲಗತ್ತಿಸಿ. ಪ್ರತಿಯೊಂದು ಶಾರ್ಟ್‌ಕಟ್ ಬೇರೆಯ ಆವೃತ್ತಿಯನ್ನು ಸೂಚಿಸಿದರೆ, ಅವೆಲ್ಲವನ್ನೂ ಟಿಪ್ಪಣಿಯೊಂದಿಗೆ ಸೇರಿಸಿ. (ಗಮನಿಸಿ: [ಸಂಚಿಕೆ #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) ಈ ಲೇಖನವು ನಿರ್ದಿಷ್ಟತೆಯನ್ನು ವಿವರಿಸುತ್ತದೆ). +- ದೊಡ್ಡ ಪ್ರಮಾಣದ ವಸ್ತುಗಳೊಂದಿಗೆ ಏಕ ಕಮಿಟ್‌ಗಳಿಗಿಂತ ಸಣ್ಣ ಬದಲಾವಣೆಗಳೊಂದಿಗೆ ಬಹು ಕಮಿಟ್‌ಗಳಿಗೆ ಆದ್ಯತೆ ನೀಡಲಾಗುತ್ತದೆ. +- ಇದು ಹಳೆಯ ಪುಸ್ತಕವಾಗಿದ್ದರೆ, ಶೀರ್ಷಿಕೆಯೊಂದಿಗೆ ಪ್ರಕಟಣೆಯ ದಿನಾಂಕವನ್ನು ಸೇರಿಸಿ. +- ದಯವಿಟ್ಟು ಲೇಖಕರ ಹೆಸರನ್ನು ನಿರ್ದಿಷ್ಟಪಡಿಸಿ. ನೀವು ಅದನ್ನು "`et al.`" ಬಳಸಿ ಕಡಿಮೆ ಮಾಡಬಹುದು. +- ಪುಸ್ತಕವು ಇನ್ನೂ ಪೂರ್ಣವಾಗಿಲ್ಲದಿದ್ದರೆ, [ಕೆಳಗೆ] (#ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ_ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ) ನಿರ್ದಿಷ್ಟಪಡಿಸಿದಂತೆ "`ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ" ಗುರುತು ಸೇರಿಸಿ. +- [*ಇಂಟರ್ನೆಟ್ ಆರ್ಕೈವ್ಸ್ ವೇಬ್ಯಾಕ್ ಮೆಷಿನ್*](https://web.archive.org) (ಅಥವಾ ಇದೇ ರೀತಿಯ) ಬಳಸಿಕೊಂಡು ಸಂಪನ್ಮೂಲವನ್ನು ಮರುಸ್ಥಾಪಿಸಿದರೆ, ವಿವರಿಸಿದಂತೆ "`ಆರ್ಕೈವ್ಡ್`" ಸಂಕೇತವನ್ನು ಸೇರಿಸಿ [ಕೆಳಗೆ](#ಆರ್ಕೈವ್ ಮಾಡಲಾಗಿದೆ) . ಬಳಸಲು ಉತ್ತಮ ಆವೃತ್ತಿಗಳು ಇತ್ತೀಚಿನವು ಮತ್ತು ಸಂಪೂರ್ಣವಾಗಿವೆ. +- ಡೌನ್‌ಲೋಡ್ ಮಾಡುವ ಮೊದಲು ಇಮೇಲ್ ವಿಳಾಸ ಅಥವಾ ಖಾತೆ ರಚನೆಯನ್ನು ವಿನಂತಿಸಿದರೆ, ದಯವಿಟ್ಟು ಪ್ರತ್ಯೇಕ ಟಿಪ್ಪಣಿಯನ್ನು ಲಗತ್ತಿಸಿ. ಉದಾಹರಣೆ: `(ಇಮೇಲ್ ವಿಳಾಸ *ವಿನಂತಿಸಲಾಗಿದೆ*, ಅಗತ್ಯವಿಲ್ಲ)`. + + +### ಮಾನದಂಡ + +- ಎಲ್ಲಾ ಪಟ್ಟಿಗಳು `.md` ಫೈಲ್ ಫಾರ್ಮ್ಯಾಟ್‌ನಲ್ಲಿರಬೇಕು. ಆ ಫಾರ್ಮ್‌ಗೆ ಸಿಂಟ್ಯಾಕ್ಸ್ ಸರಳವಾಗಿದೆ ಮತ್ತು ಇದನ್ನು [Markdown] (https://guides.github.com/features/mastering-markdown/) ನಲ್ಲಿ ಕಾಣಬಹುದು. +- ಪ್ರತಿಯೊಂದು ಪಟ್ಟಿಯು ಪರಿವಿಡಿಯೊಂದಿಗೆ ಪ್ರಾರಂಭವಾಗಬೇಕು. ಪ್ರತಿಯೊಂದು ವಿಷಯವನ್ನು ಪರಿವಿಡಿಗೆ ಲಿಂಕ್ ಮಾಡುವುದು ಗುರಿಯಾಗಿದೆ. ಇದನ್ನು ಆರೋಹಣ ಕ್ರಮದಲ್ಲಿ ವಿಂಗಡಿಸಬೇಕು. +- ಪ್ರತಿಯೊಂದು ವಿಭಾಗವು ಮೂರು ಹಂತದ ಶಿರೋನಾಮೆಯನ್ನು ಬಳಸುತ್ತದೆ (`###`). ಉಪವಿಭಾಗಗಳು ನಾಲ್ಕು ಹಂತದ ಶೀರ್ಷಿಕೆಗಳನ್ನು ಬಳಸುತ್ತವೆ (`####`). + +ಒಳಗೊಂಡಿರಬೇಕು: + +- ಕೊನೆಯ ಶಾರ್ಟ್‌ಕಟ್ ಮತ್ತು ಹೊಸ ವಿಭಾಗದ ನಡುವೆ ಲೈನ್ ಬ್ರೇಕ್ '2' +- ಹೆಡರ್ ಮತ್ತು ವಿಭಾಗದ ಮೊದಲ ಶಾರ್ಟ್‌ಕಟ್ ನಡುವೆ ಲೈನ್ ಬ್ರೇಕ್ '1' +- ಎರಡು ಶಾರ್ಟ್‌ಕಟ್‌ಗಳ ನಡುವೆ ಲೈನ್ ಬ್ರೇಕ್ '0' +- `.md` ಫೈಲ್‌ನ ಕೊನೆಯಲ್ಲಿ `1` ಲೈನ್ ಬ್ರೇಕ್ + +ಉದಾಹರಣೆ: + +```ಪಠ್ಯ +[...] +* [ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/example.html) + (ಖಾಲಿ ಸಾಲು) + (ಖಾಲಿ ಸಾಲು) +### ಉದಾಹರಣೆ + (ಖಾಲಿ ಸಾಲು) +* [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) +* [ಕೆಲವು ಇತರ ಪುಸ್ತಕ] (http://example.com/other.html) +``` + +- `]` ಮತ್ತು `(`: ನಡುವೆ ಜಾಗವನ್ನು ಹಾಕಬೇಡಿ: + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) + ಒಳ್ಳೆಯದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) + ``` + +- ಲೇಖಕರನ್ನು ಸೂಚಿಸಲು, ಬಳಸಿ ` - ` (ಸ್ಪೇಸ್ - ಸ್ಪೇಸ್): + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) - ಜಾನ್ ಡೋ + ಒಳ್ಳೆಯದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/book.html) - ಜಾನ್ ಡೋ + ``` + +- ಶಾರ್ಟ್‌ಕಟ್ ಮತ್ತು ಫಾರ್ಮ್ಯಾಟ್ ನಡುವೆ ಜಾಗವನ್ನು ಸೇರಿಸಿ: + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಬಹಳ ಅದ್ಭುತ ಪುಸ್ತಕ] (https://example.org/book.pdf) (PDF) + ಒಳ್ಳೆಯದು: * [ಬಹಳ ಅದ್ಭುತ ಪುಸ್ತಕ] (https://example.org/book.pdf) (PDF) + ``` + +- ಲೇಖಕರು ರೂಪದಿಂದ ಮುಂಚಿತವಾಗಿರುತ್ತಾರೆ: + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಅತ್ಯಂತ ಅದ್ಭುತ ಪುಸ್ತಕ] (https://example.org/book.pdf)- (PDF) ಜೇನ್ ರೋ + ಒಳ್ಳೆಯದು: * [ಬಹಳ ಅದ್ಭುತ ಪುಸ್ತಕ] (https://example.org/book.pdf) - ಜೇನ್ ರೋ (PDF) + ``` + +- ಬಹು ಫೈಲ್ ಪ್ರಕಾರಗಳು ಅಸ್ತಿತ್ವದಲ್ಲಿದ್ದಾಗ: + + ```ಪಠ್ಯ + ಕೆಟ್ಟದು: * [ಮತ್ತೊಂದು ಅದ್ಭುತ ಪುಸ್ತಕ] (http://example.com/) - ಜಾನ್ ಡೋ (HTML) + ಕೆಟ್ಟ: * [ಮತ್ತೊಂದು ಅದ್ಭುತ diff --git a/docs/HOWTO-kn.md b/docs/HOWTO-kn.md new file mode 100644 index 000000000..64cb412ba --- /dev/null +++ b/docs/HOWTO-kn.md @@ -0,0 +1,36 @@ +# ಹೇಗೆ-ಒಂದು ನೋಟದಲ್ಲಿ ️ + +
+ +*[ಈ ಲೇಖನವನ್ನು ಇತರ ಭಾಷೆಗಳಲ್ಲಿ ಓದಿ](README.md#translations)* + +
+ +**`ಉಚಿತ-ಪ್ರೋಗ್ರಾಮಿಂಗ್-ಪುಸ್ತಕಗಳಿಗೆ` ಸುಸ್ವಾಗತ!** + +ನಾವು ಹೊಸ ಕೊಡುಗೆದಾರರನ್ನು ಸ್ವಾಗತಿಸುತ್ತೇವೆ; GitHub ನಲ್ಲಿ ತಮ್ಮ ಮೊದಲ ಪುಲ್ ವಿನಂತಿಯನ್ನು (PR) ಮಾಡುವವರಿಗೂ ಸಹ. ನೀವು ಅವರಲ್ಲಿ ಒಬ್ಬರಾಗಿದ್ದರೆ, ಸಹಾಯ ಮಾಡುವ ಕೆಲವು ಸಂಪನ್ಮೂಲಗಳು ಇಲ್ಲಿವೆ: + +* [ಪುಲ್ ವಿನಂತಿಯ ಕುರಿತು](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about - ಎಳೆಯುವ ವಿನಂತಿಗಳು) *(ಇಂಗ್ಲಿಷ್‌ನಲ್ಲಿ)* +* [ಪುಲ್ ವಿನಂತಿಯನ್ನು ರಚಿಸಲಾಗುತ್ತಿದೆ](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating- a-pull-request) *(ಇಂಗ್ಲಿಷ್‌ನಲ್ಲಿ)* +* [GitHub Hello World](https://docs.github.com/en/get-started/quickstart/hello-world) *(ಇಂಗ್ಲಿಷ್‌ನಲ್ಲಿ)* +* [YouTube - ಆರಂಭಿಕರಿಗಾಗಿ GitHub ಟ್ಯುಟೋರಿಯಲ್‌ಗಳು](https://www.youtube.com/watch?v=0fKg7e37bQE) *(ಇಂಗ್ಲಿಷ್‌ನಲ್ಲಿ)* +* [YouTube - GitHub ರೆಪೋವನ್ನು ಫೋರ್ಕ್ ಮಾಡುವುದು ಮತ್ತು ಪುಲ್ ವಿನಂತಿಯನ್ನು ಸಲ್ಲಿಸುವುದು ಹೇಗೆ](https://www.youtube.com/watch?v=G1I3HF4YWEw) *(ಇಂಗ್ಲಿಷ್‌ನಲ್ಲಿ)* +* [YouTube - ಮಾರ್ಕ್‌ಡೌನ್ ಕ್ರ್ಯಾಶ್ ಕೋರ್ಸ್](https://www.youtube.com/watch?v=HUBNt18RFbo) *(ಇಂಗ್ಲಿಷ್‌ನಲ್ಲಿ)* + + +ಪ್ರಶ್ನೆಗಳನ್ನು ಕೇಳಲು ಹಿಂಜರಿಯಬೇಡಿ; ಪ್ರತಿಯೊಬ್ಬ ಕೊಡುಗೆದಾರರು ಮೊದಲು PR ನೊಂದಿಗೆ ಪ್ರಾರಂಭಿಸಿದರು. ನೀವು ನಮ್ಮ ಸಾವಿರದವರಾಗಬಹುದು! ಹಾಗಾದರೆ... ನಮ್ಮ [ದೊಡ್ಡ, ಬೆಳೆಯುತ್ತಿರುವ](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) ಸಮುದಾಯವನ್ನು ಏಕೆ ಸೇರಬಾರದು. + +
+<ಸಾರಾಂಶ>ಬಳಕೆದಾರರ ಬೆಳವಣಿಗೆ ವರ್ಸಸ್ (ವಿರುದ್ಧ) ಸಮಯದ ಗ್ರಾಫ್ ವೀಕ್ಷಿಸಲು ಕ್ಲಿಕ್ ಮಾಡಿ. + +[![EbookFoundation/free-programming-books's Contributor over time Graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)](https: http://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) + +[![EbookFoundation/free-programming-books ನ ಮಾಸಿಕ ಸಕ್ರಿಯ ಕೊಡುಗೆದಾರರ ಗ್ರಾಫ್](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)]( //www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) + + + +ನೀವು ಅನುಭವಿ ಓಪನ್ ಸೋರ್ಸ್ ಕೊಡುಗೆದಾರರಾಗಿದ್ದರೂ ಸಹ, ನಿಮ್ಮನ್ನು ಟ್ರಿಪ್ ಮಾಡುವ ವಿಷಯಗಳಿವೆ. ಒಮ್ಮೆ ನೀವು ನಿಮ್ಮ PR ಅನ್ನು ಸಲ್ಲಿಸಿದರೆ, ***GitHub ಕ್ರಿಯೆಗಳು* *ಲಿಂಟರ್* ಅನ್ನು ರನ್ ಮಾಡುತ್ತದೆ, ಆಗಾಗ್ಗೆ ಅಂತರ ಅಥವಾ ವರ್ಣಮಾಲೆಯಲ್ಲಿ ಸಣ್ಣ ಸಮಸ್ಯೆಗಳನ್ನು ಕಂಡುಕೊಳ್ಳುತ್ತದೆ**. ನೀವು ಹಸಿರು ಬಟನ್ ಅನ್ನು ಪಡೆದರೆ, ಎಲ್ಲವೂ ಪರಿಶೀಲನೆಗೆ ಸಿದ್ಧವಾಗಿದೆ, ಆದರೆ ಇಲ್ಲದಿದ್ದರೆ, ಲಿಂಟರ್ ಯಾವುದು ಇಷ್ಟವಾಗಲಿಲ್ಲ ಎಂಬುದನ್ನು ಕಂಡುಹಿಡಿಯಲು ವಿಫಲವಾದ ಚೆಕ್‌ನ ಕೆಳಗೆ "ವಿವರಗಳು" ಕ್ಲಿಕ್ ಮಾಡಿ. ಸಮಸ್ಯೆಯನ್ನು ಪರಿಹರಿಸಿ ಮತ್ತು ನಿಮ್ಮ PR ಗೆ ಬದ್ಧತೆಯನ್ನು ಸೇರಿಸಿ. + +ಅಂತಿಮವಾಗಿ, ನೀವು ಸೇರಿಸಲು ಬಯಸುವ ಸಂಪನ್ಮೂಲವು `ಉಚಿತ-ಪ್ರೋಗ್ರಾಮಿಂಗ್-ಪುಸ್ತಕಗಳಿಗೆ" ಸೂಕ್ತವಾಗಿದೆಯೇ ಎಂದು ನಿಮಗೆ ಖಚಿತವಿಲ್ಲದಿದ್ದರೆ, [ಕಾಂಟ್ರಿಬ್ಯೂಟಿಂಗ್](CONTRIBUTING.md) ನಲ್ಲಿನ ನಿರ್ದೇಶನಗಳನ್ನು ಓದಿ. ([ಅನುವಾದಗಳು](README.md#translations)) + +** ವೆಬ್‌ಸೈಟ್ [ಲಿಂಕ್](https://ebookfoundation.github.io/free-programming-books/)** diff --git a/docs/README.md b/docs/README.md index 9260d1780..eb6b40c7b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -64,6 +64,10 @@ Volunteers have translated many of our Contributing, How-to, and Code of Conduct - [Contributing](CONTRIBUTING-it.md) - [How-to](HOWTO-it.md) - Japanese / 日本語 +- Kannada / ಕನ್ನಡ + - [How To](HOWTO-kn.md) + - [Contributing](CONTRIBUTING-kn.md) + - [Code Of Conduct](CODE_OF_CONDUCT-kn.md) - Kazakh / қазақша - Khmer / Cambodian / ខ្មែរ - [How-to](HOWTO-km.md)