* added Kannada Docs * updated * updated * updated * updated * added link in docs/readme.md * corrected
33 KiB
ಕೊಡುಗೆದಾರರ ಪರವಾನಗಿ ಒಪ್ಪಂದ
ಈ ಯೋಜನೆಗೆ ಕೊಡುಗೆದಾರರು ರೆಪೊಸಿಟರಿಯ ನಿಯಮಗಳು ಅನ್ನು ಒಪ್ಪುತ್ತಾರೆ ಎಂದು ಪರಿಗಣಿಸಲಾಗುತ್ತದೆ.
ಕೊಡುಗೆದಾರರ ನೀತಿ ಸಂಹಿತೆ
ಈ ಭಂಡಾರಕ್ಕೆ ಕೊಡುಗೆ ನೀಡುವ ಮೂಲಕ, ಎಲ್ಲಾ ಕೊಡುಗೆದಾರರು ಈ [ನಡತೆ ಸಂಹಿತೆ] (CODE_OF_CONDUCT-en.md) ಗೆ ಒಪ್ಪುತ್ತಾರೆ. (ಅನುವಾದಗಳು)
ಸಾರಾಂಶ
-
"ಪುಸ್ತಕವನ್ನು ಸುಲಭವಾಗಿ ಡೌನ್ಲೋಡ್ ಮಾಡಲು ಶಾರ್ಟ್ಕಟ್" ಪುಸ್ತಕವು ಉಚಿತವಾಗಿದೆ ಎಂದು ಖಾತರಿಪಡಿಸುವುದಿಲ್ಲ. ಈ ಯೋಜನೆಗೆ ಕೊಡುಗೆ ನೀಡುವ ಮೊದಲು, ಶಾರ್ಟ್ಕಟ್ ಉಚಿತವಾಗಿದೆಯೇ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ. ಕಾರ್ಯನಿರ್ವಹಿಸುವ ಇಮೇಲ್ ಅಗತ್ಯವಿರುವ ಶಾರ್ಟ್ಕಟ್ಗಳನ್ನು ಸಹ ನಾವು ಸ್ವೀಕರಿಸುವುದಿಲ್ಲ, ಆದರೆ ಇಮೇಲ್ ಕೇಳುವವರಿಗೆ ನಾವು ಅವಕಾಶ ನೀಡುತ್ತೇವೆ.
-
ನೀವು Git ಅನ್ನು ತಿಳಿದುಕೊಳ್ಳಬೇಕಾಗಿಲ್ಲ: ನೀವು ಮಾನದಂಡವನ್ನು ಪೂರೈಸುವ ಶಾರ್ಟ್ಕಟ್ ಅನ್ನು ಈಗಾಗಲೇ ಪಟ್ಟಿ ಮಾಡಲಾಗಿಲ್ಲ ಕಂಡುಬಂದರೆ, ನಂತರ ಹೊಸ [ಸಮಸ್ಯೆ] (https://github.com/EbookFoundation/free- programming-books/issues )
- Git ಅನ್ನು ಹೇಗೆ ಬಳಸುವುದು ಎಂದು ನಿಮಗೆ ತಿಳಿದಿದ್ದರೆ, ರೆಪೊಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ ಮತ್ತು ಪುಲ್ ವಿನಂತಿಯನ್ನು (PR) ಕಳುಹಿಸಿ.
-
ನಾವು ಆರು ರೀತಿಯ ಪಟ್ಟಿಗಳನ್ನು ಒದಗಿಸುತ್ತೇವೆ. ದಯವಿಟ್ಟು ಸರಿಯಾದದನ್ನು ಆಯ್ಕೆಮಾಡಿ:
- ಪುಸ್ತಕಗಳು: 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).
- ಆಟದ ಮೈದಾನಗಳು : ಪ್ರೋಗ್ರಾಮಿಂಗ್ ಕಲಿಯಲು ಆನ್ಲೈನ್ ಮತ್ತು ಸಂವಾದಾತ್ಮಕ ವೆಬ್ಸೈಟ್ಗಳು, ಆಟಗಳು ಅಥವಾ ಡೆಸ್ಕ್ಟಾಪ್ ಸಾಫ್ಟ್ವೇರ್. ಕೋಡ್ ತುಣುಕುಗಳನ್ನು ಬರೆಯಿರಿ, ಕಂಪೈಲ್ ಮಾಡಿ (ಅಥವಾ ರನ್ ಮಾಡಿ) ಮತ್ತು ಹಂಚಿಕೊಳ್ಳಿ. ಆಟದ ಮೈದಾನಗಳು ಸಾಮಾನ್ಯವಾಗಿ ಕೋಡ್ನೊಂದಿಗೆ ಆಡುವ ಮೂಲಕ ನಿಮ್ಮ ಕೈಗಳನ್ನು ಫೋರ್ಕ್ ಮಾಡಲು ಮತ್ತು ಕೊಳಕು ಮಾಡಲು ಅನುಮತಿಸುತ್ತದೆ.
- ಪಾಡ್ಕ್ಯಾಸ್ಟ್ ಮತ್ತು ಸ್ಕ್ರೀನ್ ರೆಕಾರ್ಡಿಂಗ್
- ಸಮಸ್ಯೆ ಪುಸ್ತಕ ಮತ್ತು ಸ್ಪರ್ಧಾತ್ಮಕ ಪ್ರೋಗ್ರಾಮಿಂಗ್: ಇದು ಸಮಸ್ಯೆಗಳನ್ನು ಪರಿಹರಿಸುವ ಮೂಲಕ ಪ್ರೋಗ್ರಾಮಿಂಗ್ ಕೌಶಲ್ಯಗಳನ್ನು ಸುಧಾರಿಸಲು ಸಹಾಯ ಮಾಡುವ ಸಾಫ್ಟ್ವೇರ್ ಅಥವಾ ವೆಬ್ಸೈಟ್ಗಳನ್ನು ಉಲ್ಲೇಖಿಸುತ್ತದೆ. ಅಂತಹ ಸಾಫ್ಟ್ವೇರ್ ಅಥವಾ ವೆಬ್ಸೈಟ್ಗಳು ಪೀರ್-ನಿರ್ದೇಶಿತ ಕೋಡ್ ವಿಮರ್ಶೆಗಳನ್ನು ಒಳಗೊಂಡಿರಬಹುದು.
-
ಕೆಳಗಿನ [ಮಾರ್ಗಸೂಚಿ] (#ಮಾರ್ಗಸೂಚಿ) ಅನ್ನು ನೋಡಿ ಮತ್ತು [ಮಾರ್ಕ್ಡೌನ್ ಮಾನದಂಡ] (#ಸ್ಟ್ಯಾಂಡರ್ಡ್) ಅನ್ನು ಅನುಸರಿಸಿ.
-
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
) - ಶಾರ್ಟ್ಕಟ್ನ ಪ್ರಮಾಣಪತ್ರದ ಅವಧಿ ಮುಗಿದಿದ್ದರೆ:
http
ಫಾರ್ಮ್ಯಾಟ್ನೊಂದಿಗೆ ಬದಲಿ ಮಾಡಿhttp
ಆವೃತ್ತಿಯು ಅಸ್ತಿತ್ವದಲ್ಲಿಲ್ಲದಿದ್ದರೆ, ಅಸ್ತಿತ್ವದಲ್ಲಿರುವ ಲಿಂಕ್ ಅನ್ನು ಬಳಸಿ. ನೀವು ವಿನಾಯಿತಿಯನ್ನು ಸೇರಿಸಿದರೆhttps
ಸ್ವರೂಪವನ್ನು ಸಹ ಬಳಸಬಹುದು.- ಹೊರತುಪಡಿಸು
- ಶಾರ್ಟ್ಕಟ್ ಬಹು ಸ್ವರೂಪಗಳಲ್ಲಿ ಅಸ್ತಿತ್ವದಲ್ಲಿದ್ದರೆ, ದಯವಿಟ್ಟು ಪ್ರತಿಯೊಂದನ್ನು ಟಿಪ್ಪಣಿಯೊಂದಿಗೆ ಲಗತ್ತಿಸಿ.
- ವಸ್ತುವು ಬಹು ಸೈಟ್ಗಳಲ್ಲಿ ಹರಡಿದ್ದರೆ, ಅತ್ಯಂತ ವಿಶ್ವಾಸಾರ್ಹ ಶಾರ್ಟ್ಕಟ್ ಅನ್ನು ಲಗತ್ತಿಸಿ. ಪ್ರತಿಯೊಂದು ಶಾರ್ಟ್ಕಟ್ ಬೇರೆಯ ಆವೃತ್ತಿಯನ್ನು ಸೂಚಿಸಿದರೆ, ಅವೆಲ್ಲವನ್ನೂ ಟಿಪ್ಪಣಿಯೊಂದಿಗೆ ಸೇರಿಸಿ. (ಗಮನಿಸಿ: ಸಂಚಿಕೆ #2353 ಈ ಲೇಖನವು ನಿರ್ದಿಷ್ಟತೆಯನ್ನು ವಿವರಿಸುತ್ತದೆ).
- ದೊಡ್ಡ ಪ್ರಮಾಣದ ವಸ್ತುಗಳೊಂದಿಗೆ ಏಕ ಕಮಿಟ್ಗಳಿಗಿಂತ ಸಣ್ಣ ಬದಲಾವಣೆಗಳೊಂದಿಗೆ ಬಹು ಕಮಿಟ್ಗಳಿಗೆ ಆದ್ಯತೆ ನೀಡಲಾಗುತ್ತದೆ.
- ಇದು ಹಳೆಯ ಪುಸ್ತಕವಾಗಿದ್ದರೆ, ಶೀರ್ಷಿಕೆಯೊಂದಿಗೆ ಪ್ರಕಟಣೆಯ ದಿನಾಂಕವನ್ನು ಸೇರಿಸಿ.
- ದಯವಿಟ್ಟು ಲೇಖಕರ ಹೆಸರನ್ನು ನಿರ್ದಿಷ್ಟಪಡಿಸಿ. ನೀವು ಅದನ್ನು "
et al.
" ಬಳಸಿ ಕಡಿಮೆ ಮಾಡಬಹುದು. - ಪುಸ್ತಕವು ಇನ್ನೂ ಪೂರ್ಣವಾಗಿಲ್ಲದಿದ್ದರೆ, [ಕೆಳಗೆ] (#ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ_ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ) ನಿರ್ದಿಷ್ಟಪಡಿಸಿದಂತೆ "`ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ" ಗುರುತು ಸೇರಿಸಿ.
- ಇಂಟರ್ನೆಟ್ ಆರ್ಕೈವ್ಸ್ ವೇಬ್ಯಾಕ್ ಮೆಷಿನ್ (ಅಥವಾ ಇದೇ ರೀತಿಯ) ಬಳಸಿಕೊಂಡು ಸಂಪನ್ಮೂಲವನ್ನು ಮರುಸ್ಥಾಪಿಸಿದರೆ, ವಿವರಿಸಿದಂತೆ "
ಆರ್ಕೈವ್ಡ್
" ಸಂಕೇತವನ್ನು ಸೇರಿಸಿ [ಕೆಳಗೆ](#ಆರ್ಕೈವ್ ಮಾಡಲಾಗಿದೆ) . ಬಳಸಲು ಉತ್ತಮ ಆವೃತ್ತಿಗಳು ಇತ್ತೀಚಿನವು ಮತ್ತು ಸಂಪೂರ್ಣವಾಗಿವೆ. - ಡೌನ್ಲೋಡ್ ಮಾಡುವ ಮೊದಲು ಇಮೇಲ್ ವಿಳಾಸ ಅಥವಾ ಖಾತೆ ರಚನೆಯನ್ನು ವಿನಂತಿಸಿದರೆ, ದಯವಿಟ್ಟು ಪ್ರತ್ಯೇಕ ಟಿಪ್ಪಣಿಯನ್ನು ಲಗತ್ತಿಸಿ. ಉದಾಹರಣೆ:
(ಇಮೇಲ್ ವಿಳಾಸ *ವಿನಂತಿಸಲಾಗಿದೆ*, ಅಗತ್ಯವಿಲ್ಲ)
.
ಮಾನದಂಡ
- ಎಲ್ಲಾ ಪಟ್ಟಿಗಳು
.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) ಗೆ ಒಪ್ಪುತ್ತಾರೆ. (ಅನುವಾದಗಳು)
ಸಾರಾಂಶ
-
"ಪುಸ್ತಕವನ್ನು ಸುಲಭವಾಗಿ ಡೌನ್ಲೋಡ್ ಮಾಡಲು ಶಾರ್ಟ್ಕಟ್" ಪುಸ್ತಕವು ಉಚಿತವಾಗಿದೆ ಎಂದು ಖಾತರಿಪಡಿಸುವುದಿಲ್ಲ. ಈ ಯೋಜನೆಗೆ ಕೊಡುಗೆ ನೀಡುವ ಮೊದಲು, ಶಾರ್ಟ್ಕಟ್ ಉಚಿತವಾಗಿದೆಯೇ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ. ಕಾರ್ಯನಿರ್ವಹಿಸುವ ಇಮೇಲ್ ಅಗತ್ಯವಿರುವ ಶಾರ್ಟ್ಕಟ್ಗಳನ್ನು ಸಹ ನಾವು ಸ್ವೀಕರಿಸುವುದಿಲ್ಲ, ಆದರೆ ಇಮೇಲ್ ಕೇಳುವವರಿಗೆ ನಾವು ಅವಕಾಶ ನೀಡುತ್ತೇವೆ.
-
ನೀವು Git ಅನ್ನು ತಿಳಿದುಕೊಳ್ಳಬೇಕಾಗಿಲ್ಲ: ನೀವು ಮಾನದಂಡವನ್ನು ಪೂರೈಸುವ ಶಾರ್ಟ್ಕಟ್ ಅನ್ನು ಈಗಾಗಲೇ ಪಟ್ಟಿ ಮಾಡಲಾಗಿಲ್ಲ ಕಂಡುಬಂದರೆ, ನಂತರ ಹೊಸ [ಸಮಸ್ಯೆ] (https://github.com/EbookFoundation/free- programming-books/issues )
- Git ಅನ್ನು ಹೇಗೆ ಬಳಸುವುದು ಎಂದು ನಿಮಗೆ ತಿಳಿದಿದ್ದರೆ, ರೆಪೊಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ ಮತ್ತು ಪುಲ್ ವಿನಂತಿಯನ್ನು (PR) ಕಳುಹಿಸಿ.
-
ನಾವು ಆರು ರೀತಿಯ ಪಟ್ಟಿಗಳನ್ನು ಒದಗಿಸುತ್ತೇವೆ. ದಯವಿಟ್ಟು ಸರಿಯಾದದನ್ನು ಆಯ್ಕೆಮಾಡಿ:
- ಪುಸ್ತಕಗಳು: 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).
- ಆಟದ ಮೈದಾನಗಳು : ಪ್ರೋಗ್ರಾಮಿಂಗ್ ಕಲಿಯಲು ಆನ್ಲೈನ್ ಮತ್ತು ಸಂವಾದಾತ್ಮಕ ವೆಬ್ಸೈಟ್ಗಳು, ಆಟಗಳು ಅಥವಾ ಡೆಸ್ಕ್ಟಾಪ್ ಸಾಫ್ಟ್ವೇರ್. ಕೋಡ್ ತುಣುಕುಗಳನ್ನು ಬರೆಯಿರಿ, ಕಂಪೈಲ್ ಮಾಡಿ (ಅಥವಾ ರನ್ ಮಾಡಿ) ಮತ್ತು ಹಂಚಿಕೊಳ್ಳಿ. ಆಟದ ಮೈದಾನಗಳು ಸಾಮಾನ್ಯವಾಗಿ ಕೋಡ್ನೊಂದಿಗೆ ಆಡುವ ಮೂಲಕ ನಿಮ್ಮ ಕೈಗಳನ್ನು ಫೋರ್ಕ್ ಮಾಡಲು ಮತ್ತು ಕೊಳಕು ಮಾಡಲು ಅನುಮತಿಸುತ್ತದೆ.
- ಪಾಡ್ಕ್ಯಾಸ್ಟ್ ಮತ್ತು ಸ್ಕ್ರೀನ್ ರೆಕಾರ್ಡಿಂಗ್
- ಸಮಸ್ಯೆ ಪುಸ್ತಕ ಮತ್ತು ಸ್ಪರ್ಧಾತ್ಮಕ ಪ್ರೋಗ್ರಾಮಿಂಗ್: ಇದು ಸಮಸ್ಯೆಗಳನ್ನು ಪರಿಹರಿಸುವ ಮೂಲಕ ಪ್ರೋಗ್ರಾಮಿಂಗ್ ಕೌಶಲ್ಯಗಳನ್ನು ಸುಧಾರಿಸಲು ಸಹಾಯ ಮಾಡುವ ಸಾಫ್ಟ್ವೇರ್ ಅಥವಾ ವೆಬ್ಸೈಟ್ಗಳನ್ನು ಉಲ್ಲೇಖಿಸುತ್ತದೆ. ಅಂತಹ ಸಾಫ್ಟ್ವೇರ್ ಅಥವಾ ವೆಬ್ಸೈಟ್ಗಳು ಪೀರ್-ನಿರ್ದೇಶಿತ ಕೋಡ್ ವಿಮರ್ಶೆಗಳನ್ನು ಒಳಗೊಂಡಿರಬಹುದು.
-
ಕೆಳಗಿನ [ಮಾರ್ಗಸೂಚಿ] (#ಮಾರ್ಗಸೂಚಿ) ಅನ್ನು ನೋಡಿ ಮತ್ತು [ಮಾರ್ಕ್ಡೌನ್ ಮಾನದಂಡ] (#ಸ್ಟ್ಯಾಂಡರ್ಡ್) ಅನ್ನು ಅನುಸರಿಸಿ.
-
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
) - ಶಾರ್ಟ್ಕಟ್ನ ಪ್ರಮಾಣಪತ್ರದ ಅವಧಿ ಮುಗಿದಿದ್ದರೆ:
http
ಫಾರ್ಮ್ಯಾಟ್ನೊಂದಿಗೆ ಬದಲಿ ಮಾಡಿhttp
ಆವೃತ್ತಿಯು ಅಸ್ತಿತ್ವದಲ್ಲಿಲ್ಲದಿದ್ದರೆ, ಅಸ್ತಿತ್ವದಲ್ಲಿರುವ ಲಿಂಕ್ ಅನ್ನು ಬಳಸಿ. ನೀವು ವಿನಾಯಿತಿಯನ್ನು ಸೇರಿಸಿದರೆhttps
ಸ್ವರೂಪವನ್ನು ಸಹ ಬಳಸಬಹುದು.- ಹೊರತುಪಡಿಸು
- ಶಾರ್ಟ್ಕಟ್ ಬಹು ಸ್ವರೂಪಗಳಲ್ಲಿ ಅಸ್ತಿತ್ವದಲ್ಲಿದ್ದರೆ, ದಯವಿಟ್ಟು ಪ್ರತಿಯೊಂದನ್ನು ಟಿಪ್ಪಣಿಯೊಂದಿಗೆ ಲಗತ್ತಿಸಿ.
- ವಸ್ತುವು ಬಹು ಸೈಟ್ಗಳಲ್ಲಿ ಹರಡಿದ್ದರೆ, ಅತ್ಯಂತ ವಿಶ್ವಾಸಾರ್ಹ ಶಾರ್ಟ್ಕಟ್ ಅನ್ನು ಲಗತ್ತಿಸಿ. ಪ್ರತಿಯೊಂದು ಶಾರ್ಟ್ಕಟ್ ಬೇರೆಯ ಆವೃತ್ತಿಯನ್ನು ಸೂಚಿಸಿದರೆ, ಅವೆಲ್ಲವನ್ನೂ ಟಿಪ್ಪಣಿಯೊಂದಿಗೆ ಸೇರಿಸಿ. (ಗಮನಿಸಿ: ಸಂಚಿಕೆ #2353 ಈ ಲೇಖನವು ನಿರ್ದಿಷ್ಟತೆಯನ್ನು ವಿವರಿಸುತ್ತದೆ).
- ದೊಡ್ಡ ಪ್ರಮಾಣದ ವಸ್ತುಗಳೊಂದಿಗೆ ಏಕ ಕಮಿಟ್ಗಳಿಗಿಂತ ಸಣ್ಣ ಬದಲಾವಣೆಗಳೊಂದಿಗೆ ಬಹು ಕಮಿಟ್ಗಳಿಗೆ ಆದ್ಯತೆ ನೀಡಲಾಗುತ್ತದೆ.
- ಇದು ಹಳೆಯ ಪುಸ್ತಕವಾಗಿದ್ದರೆ, ಶೀರ್ಷಿಕೆಯೊಂದಿಗೆ ಪ್ರಕಟಣೆಯ ದಿನಾಂಕವನ್ನು ಸೇರಿಸಿ.
- ದಯವಿಟ್ಟು ಲೇಖಕರ ಹೆಸರನ್ನು ನಿರ್ದಿಷ್ಟಪಡಿಸಿ. ನೀವು ಅದನ್ನು "
et al.
" ಬಳಸಿ ಕಡಿಮೆ ಮಾಡಬಹುದು. - ಪುಸ್ತಕವು ಇನ್ನೂ ಪೂರ್ಣವಾಗಿಲ್ಲದಿದ್ದರೆ, [ಕೆಳಗೆ] (#ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ_ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ) ನಿರ್ದಿಷ್ಟಪಡಿಸಿದಂತೆ "`ಪ್ರಕ್ರಿಯೆಯಲ್ಲಿ" ಗುರುತು ಸೇರಿಸಿ.
- ಇಂಟರ್ನೆಟ್ ಆರ್ಕೈವ್ಸ್ ವೇಬ್ಯಾಕ್ ಮೆಷಿನ್ (ಅಥವಾ ಇದೇ ರೀತಿಯ) ಬಳಸಿಕೊಂಡು ಸಂಪನ್ಮೂಲವನ್ನು ಮರುಸ್ಥಾಪಿಸಿದರೆ, ವಿವರಿಸಿದಂತೆ "
ಆರ್ಕೈವ್ಡ್
" ಸಂಕೇತವನ್ನು ಸೇರಿಸಿ [ಕೆಳಗೆ](#ಆರ್ಕೈವ್ ಮಾಡಲಾಗಿದೆ) . ಬಳಸಲು ಉತ್ತಮ ಆವೃತ್ತಿಗಳು ಇತ್ತೀಚಿನವು ಮತ್ತು ಸಂಪೂರ್ಣವಾಗಿವೆ. - ಡೌನ್ಲೋಡ್ ಮಾಡುವ ಮೊದಲು ಇಮೇಲ್ ವಿಳಾಸ ಅಥವಾ ಖಾತೆ ರಚನೆಯನ್ನು ವಿನಂತಿಸಿದರೆ, ದಯವಿಟ್ಟು ಪ್ರತ್ಯೇಕ ಟಿಪ್ಪಣಿಯನ್ನು ಲಗತ್ತಿಸಿ. ಉದಾಹರಣೆ:
(ಇಮೇಲ್ ವಿಳಾಸ *ವಿನಂತಿಸಲಾಗಿದೆ*, ಅಗತ್ಯವಿಲ್ಲ)
.
ಮಾನದಂಡ
- ಎಲ್ಲಾ ಪಟ್ಟಿಗಳು
.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) ಕೆಟ್ಟ: * [ಮತ್ತೊಂದು ಅದ್ಭುತ