貢獻

希望讓 ghostwriter 變得更好嗎？請閱讀以下章節來看您能夠貢獻什麼。

問題報告

找到臭蟲了嗎？請在 KDE 問題追蹤平台上回報它。請別忘記遵守問題回報指引！最重要的是，請別忘記寫下您所使用的 ghostwriter 版本號碼。

警告：未提供問題回報範本中必要的資訊會使問題回報立即被自動關閉。

錯誤分類

您可以在問題追蹤平台上幫忙分類問題，亦即幫忙看如何重新產生問題，並從回報者取得更多資訊，幫助發現問題是出在哪裡。將重複的議題關閉或是其他的整理也有幫助。更多資訊請見錯誤分類準則 (bug triaging guidelines)。

新功能與錯誤修正

您會寫程式嗎？請跟隨這些步驟：

  1. 在 KDE 議題追蹤平台 上為您的功能或臭蟲提交議題。
    **注意：**這個步驟是必要的，來確保新功能符合專案的方向，以及臭蟲真的是臭蟲而不是功能。您也會需要協調您將會變更的程式碼的區域，來避免有別人也在同個區域進行工作時造成需要解決的合併衝突。
  2. 在您的新議題討論之後，開始為您的功能或臭蟲修正寫程式碼。請跟隨 KDE Frameworks 程式碼風格指南。重要：*請讓程式碼專注於該議題。*不相關的變更應該屬於別的議題或合併請求，讓 code review 和測試不要太難。
  3. Submit a pull request against the master branch with your code updates.
    Important: Please squash your commits in git before submitting the pull request!
  4. Wait for a brief code review and at least two other volunteers to test your feature or bug fix.
  5. 隨著您得到回饋，繼續更新您的 PR。
  6. 您的 PR 被至少兩個志工測試者准許之後，您的 PR 便會被合併。

Code Review

您會寫程式且注重細節嗎？來幫忙審閱新的合併請求吧！

  1. 找新的合併請求，然後留一個留言告知您希望進行 code review。
  2. 提交 code review 留言。
  3. 等待合併請求的更新（如果需要的話）。
  4. 持續提供回饋，直到您有自信認為程式碼是沒有問題的。
  5. 留下您接受合併請求的留言。
  6. 至少兩個義工測試者提交接受之後，合併請求才會被合併。

Here are some tips of what to look for in code reviews:

  • 提交的程式碼符合 KDE Frameworks 程式碼風格指南嗎？
  • 程式碼好讀嗎？有用註解解釋用途不明顯的部分嗎？
  • Is the code "pessimistic"? In other words, does it check for invalid values before using them and handle possible error conditions?
  • Are multiple comparisons or statements wrapped in parentheses within if statements to prevent accidents with order of operations? Examples:
    // 錯誤
if (a == b || c > d);

// 正確
if ((a == b) || (c > d));
  • Are literals on the left side of the == operator to prevent a typo with the = operator from escaping the compiler's notice? Examples:
    // 錯誤
if (variable == 1);

//         Reason: What if there's a typo? The compiler will not catch it!
if (variable = 1); // 糟糕！
// 正確
if (1 == variable);

//         Reason: This time the compiler will catch the typo.
if (1 = variable); // 糟糕！

測試

Volunteer to review code and test new features and bug fixes! Follow these steps:

  1. Look for a new merge request, and add a comment that you are volunteering to test it.
  2. Build the merge request on your platform.
  3. Test the feature/bug fix and try to break it!
  4. Provide feedback on test results in the merge request.
  5. 等待合併請求的更新（如果需要的話）。
  6. Continue testing and providing feedback until you are confident the code is working.
  7. 留下您接受合併請求的留言。
  8. Once at least one other volunteer tester submits their approval, the merge request will be accepted.

翻譯

請考慮加入 KDE 翻譯團隊並將您喜歡的應用程式翻譯成其他語言。

技術支援

Knowledgeable about Linux or building for MacOS? Know how to fix that one issue others keep running into? Your answering user questions and troubleshooting in the KDE bug tracker would be much appreciated!