ການປະກອບສ່ວນເຂົ້າໃນບັນທຶກການປ່ອຍ (Release Notes)
ພາກນີ້ອະທິບາຍກ່ຽວກັບວິທີການປະກອບສ່ວນເຂົ້າໃນບັນທຶກການປ່ອຍຂອງ Fedora. ກ່ອນທີ່ທ່ານຈະເລີ່ມປະຕິບັດຕາມຂັ້ນຕອນນີ້, ໃຫ້ແນ່ໃຈວ່າທ່ານໄດ້ປະຕິບັດຕາມຂໍ້ກຳນົດທັງໝົດທີ່ລະບຸໄວ້ໃນ ສິ່ງທີ່ຕ້ອງມີກ່ອນ.
| ຂະບວນການປະກອບສ່ວນໃນບັນທຶກການປ່ອຍແມ່ນຢູ່ໃນໜ້າແຍກຕ່າງຫາກ ເພາະວ່າມັນແຕກຕ່າງຈາກເອກະສານ Fedora ອື່ນໆ. ຫາກທ່ານມີຄວາມສົນໃຈໃນການປະກອບສ່ວນເຂົ້າໃນເອກະສານອື່ນໆ, ໃຫ້ເບິ່ງທີ່ໜ້າທີ່ກ່ຽວຂ້ອງ. |
ບັນທຶກການປ່ອຍແມ່ນມີຄວາມເປັນເອກະລັກ ເພາະວ່າບໍ່ຄືກັບເອກະສານອື່ນໆ, ພວກມັນຖືກຂຽນຂຶ້ນໃໝ່ທັງໝົດສຳລັບແຕ່ລະລຸ້ນທີ່ປ່ອຍອອກມາ, ໃນຂະນະທີ່ເອກະສານອື່ນໆຈະຖືກເກັບຮັກສາໄວ້ລະຫວ່າງລຸ້ນ ແລະ ມີພຽງແຕ່ການອັບເດດເທົ່ານັ້ນ. ນີ້ໝາຍຄວາມວ່າບາງສ່ວນຂອງຂັ້ນຕອນລຸ່ມນີ້, ເຊັ່ນ ສາຂາ (branch) ຂອງ git ທີ່ໃຊ້ ຫຼື ກຳນົດເວລາ, ຈະປ່ຽນແປງໄປຕາມແຕ່ລະລຸ້ນໃໝ່. ກ່ອນທີ່ທ່ານຈະເລີ່ມຂຽນບັນທຶກການປ່ອຍ, ໃຫ້ເບິ່ງ ແທັກ #docs ໃນ Fedora Discussion, ໂດຍສະເພາະແຖບດ້ານຂ້າງຢູ່ເບື້ອງຂວາ. ທ່ານຈະພົບເຫັນຂໍ້ມູນປັດຈຸບັນໄດ້ຢູ່ທີ່ນັ້ນ.
ວິທີການປະກອບສ່ວນເຂົ້າໃນບັນທຶກການປ່ອຍຂອງ Fedora
-
ກວດເບິ່ງແຖບດ້ານຂ້າງໃນ Fedora Discussion, ແລະ ສັງເກດຂໍ້ມູນທີ່ໃຫ້ໄວ້: ລຸ້ນທີ່ປ່ອຍ, ກຳນົດເວລາ, ສາຂາ (branch), ແລະ ລິ້ງໄປຫາລາຍການບັນຫາ (issues) ທີ່ກ່ຽວຂ້ອງ.
-
ເລືອກເອົາໜຶ່ງ ຫຼື ຫຼາຍບັນຫາຈາກລາຍການບັນຫາທີ່ເປີດຢູ່ ແລະ ຍັງບໍ່ມີຜູ້ຮັບຜິດຊອບ ສຳລັບລຸ້ນທີ່ທ່ານຕ້ອງການຈະປະກອບສ່ວນ.
-
ເປີດແຕ່ລະບັນຫາທີ່ທ່ານເລືອກ, ແລະ ກົດປຸ່ມ Take ຢູ່ເບື້ອງຂວາເພື່ອຮັບຜິດຊອບບັນຫານັ້ນ.
ຫາກທ່ານຈອງບັນຫາໃດໜຶ່ງໄວ້, ແຕ່ພາຍຫຼັງພົບວ່າທ່ານບໍ່ມີເວລາເຮັດໃຫ້ສຳເລັດ, ໃຫ້ຖອນຊື່ຂອງທ່ານອອກຈາກບັນຫານັ້ນໂດຍໄວທີ່ສຸດ ເພື່ອໃຫ້ຜູ້ອື່ນສາມາດຮັບໄປເຮັດຕໍ່ໄດ້. -
ຊອກຫາຂໍ້ມູນກ່ຽວກັບບັນຫາຂອງທ່ານ. ຫຼາຍບັນຫາມີຂໍ້ມູນຢ່າງພຽງພໍຢູ່ແລ້ວ, ໂດຍສະເພາະໃນລິ້ງ Wiki; ຫາກທ່ານຕ້ອງການຂໍ້ມູນເພີ່ມເຕີມ, ໃຫ້ຊອກຫາວ່າໃຜເປັນຜູ້ຮັບຜິດຊອບຕໍ່ການປ່ຽນແປງນັ້ນ (ເຊິ່ງມີລາຍຊື່ຢູ່ໃນໜ້າ Wiki ທີ່ເຊື່ອມໂຍງໃນບັນຫາ), ແລະ @-mention ພວກເຂົາໃນຄຳເຫັນຂອງບັນຫາ ຫຼື ສົນທະນາກັບພວກເຂົາທາງ IRC/Matrix ຫຼື ຜ່ານອີເມລ. ຂໍໃຫ້ຈື່ໄວ້ວ່າ ມັນຈະດີກວ່າສະເໝີຫາກທ່ານພະຍາຍາມຄົ້ນຄວ້າກ່ອນທີ່ຈະຖາມຄຳຖາມ. ສັງເກດວ່າທ່ານອາດຈະບໍ່ສາມາດຕິດຕໍ່ເຈົ້າຂອງບັນຫາໄດ້ໃນໄລຍະເວລາທີ່ເໝາະສົມສະເໝີໄປ; ໃນກໍລະນີນັ້ນ ໃຫ້ເຮັດໃຫ້ດີທີ່ສຸດ, ຫາກມີບາງຢ່າງຜິດພາດ, ພວກເຮົາສາມາດອັບເດດມັນໄດ້ໃນພາຍຫຼັງ.
-
ຂຽນບັນທຶກການປ່ອຍກ່ຽວກັບບັນຫານັ້ນ. ຫາກທ່ານບໍ່ແນ່ໃຈວ່າບັນທຶກການປ່ອຍມີລັກສະນະແນວໃດ, ໃຫ້ເບິ່ງບາງສ່ວນຂອງ ລຸ້ນທີ່ຜ່ານມາ ເພື່ອເປັນແຮງບັນດານໃຈ. ພວກເຮົາບໍ່ຕ້ອງການຂໍ້ຄວາມທີ່ຍາວ ຫຼື ເປັນທາງເຕັກນິກເກີນໄປ, ໂດຍທົ່ວໄປແລ້ວ ບັນທຶກການປ່ອຍມີໄວ້ເພື່ອເນັ້ນການປ່ຽນແປງ, ບໍ່ແມ່ນເພື່ອບອກວິທີການໃຊ້ງານສິ່ງໃດສິ່ງໜຶ່ງ.
-
ຕອນນີ້ ຂັ້ນຕອນການເຮັດວຽກຈະແຍກອອກຕາມສິດໃນ Pagure ແລະ ທັກສະທາງເຕັກນິກຂອງທ່ານ:
-
ຫາກທ່ານຮູ້ວິທີການໃຊ້ git ແລະ ASCIIDoc, ໃຫ້ຂຽນບັນທຶກການປ່ອຍ ແລະ ສົ່ງ pull request ໄປຍັງຄັງເກັບຫຼັກ (main repository). ໃຫ້ແນ່ໃຈວ່າທ່ານເປີດ pull request ໃສ່ສາຂາ (branch) ທີ່ຖືກຕ້ອງ, ບໍ່ແມ່ນ
main- ເບິ່ງຂັ້ນຕອນທຳອິດຂອງຂະບວນການນີ້ສຳລັບຂໍ້ມູນ. (ສາຂາmainຖືກໃຊ້ເປັນພຽງແມ່ແບບສຳລັບແຕ່ລະລຸ້ນໃໝ່ເທົ່ານັ້ນ, ດັ່ງນັ້ນມັນຈຶ່ງມີພຽງໂຄງສ້າງທີ່ວ່າງເປົ່າ ແລະ ບາງໜ້າທີ່ບໍ່ມີການປ່ຽນແປງລະຫວ່າງລຸ້ນ.) ການປະກອບສ່ວນຂອງທ່ານຄວນໃສ່ລົງໃນໄຟລ໌ໃດໜຶ່ງໃນmodules/release-notes/pages/, ເຊິ່ງຈະແມ່ນໄຟລ໌ໃດນັ້ນແມ່ນຂຶ້ນກັບເນື້ອໃນຂອງການປ່ຽນແປງທີ່ທ່ານກຳລັງຂຽນເອກະສານຢູ່.
-
ຫາກທ່ານບໍ່ເຫັນພາກສ່ວນທີ່ທ່ານເພີ່ມການປະກອບສ່ວນເຂົ້າໄປເລີຍ, ໃຫ້ກວດເບິ່ງໃຫ້ແນ່ໃຈວ່າມັນໄດ້ຖືກລວມເຂົ້າໃນສາລະບານໃນ modules/release-notes/nav.adoc ແລ້ວ.
+ * ຫາກສິ່ງທີ່ກ່າວມາຂ້າງເທິງນັ້ນຟັງເບິ່ງເຂົ້າໃຈຍາກສຳລັບທ່ານ, ກໍບໍ່ເປັນຫຍັງ. ພຽງແຕ່ເພີ່ມຄຳເຫັນພ້ອມກັບຂໍ້ຄວາມຂອງທ່ານລົງໃນບັນຫາ (issue), ແລ້ວຈະມີຄົນນຳໄປຈັດຮູບແບບ ແລະ ເພີ່ມເຂົ້າໃນເອກະສານຂັ້ນສຸດທ້າຍເອງ.
ເຮັດຊ້ຳຂັ້ນຕອນຂ້າງເທິງສຳລັບບັນຫາອື່ນໆ ຕາມທີ່ທ່ານຕ້ອງການ.
Want to help? Learn how to contribute to Fedora Docs ›