## Pull requests `Pull requests` 是github上面一個很重要的功能，竟然很多人從字面簡單的翻譯成為“拉請求”，實際上應該翻譯為“合并請求”，這個功能在多人合作，團隊合作，開源寫作中有很大的用處，我們個人開發，一般直接合并分支，但是寫作開發時就有時就需要一個可以“發出一個合并請求”的功能，以讓其他人看到你的“合并申請”，最終完成合并，理所當然，這個功能就是Pull requests了，它只是發出一個合并的請求信號，所以它是合并請求，請不要再說成什么“拉取請求”了，很多時候從詞義就基本能看出某個功能的作用了，往往不合的釋義除了造成理解上的困難，更會造成學習上的阻礙，不能很好的體會到真正含義，也就不能真正掌握理解了。（這個說法可能也有一定的描述性錯誤，但本質就是這是發起一個請求） >[info] 創建一個拉拽請求（Pull Request），讓核心團隊的開發者到自己的版本庫來抓取（Pull）。 Pull requests其實也是一種issues哦，相當于一個有代碼changes的issues哦，難道你沒發現他們的操作很像嗎，并且一個Pull requests也占一個issues #ID哦，#ID也能選擇Pull requests。原來他們是一個東西哈。 如果一開始看到這個了，或許不會有上面的糾結了。 >[info] git pull = git fetch + git merge ---- ~~~shell # 查看所有遠程源 $: git remote -v # 添加默認遠程源地址 $: git remote add origin git@e.coding.net:yfjt/yf/yf_api.git # 設置本地倉庫默認源地址（之前已有其它源的話） $: git remote set-url origin git@e.coding.net:yfjt/yf/yf_api.git # 推送所有分支到遠程源 $: git push --all origin # 推送所有標簽到遠程源 $: git push --tags origin # 拉取某個分支 $: git pull kf # 推送當前分支 $: git push # 推送 master 分支 到 源 origin $: git push origin master # 切換當前分支 $: git checkout test ~~~ ---- https://github.com/reactjs/zh-hans.reactjs.org/ 此倉庫包含[React 中文文檔](https://zh-hans.reactjs.org/)的文檔及源碼，并由官方實時同步。 ## [](https://github.com/reactjs/zh-hans.reactjs.org/#關于翻譯內容反饋)關于翻譯內容反饋 翻譯基本接近尾聲，但文檔中也有可能存在疏漏之處。 如在閱讀文檔中，遇到文檔的問題可直接 PR 修改。 也可添加反饋群。我們會及時給出反饋。 當然也可以在群里交流 React 相關的交流心得，非常歡迎。 希望大家共同把這個文檔維護好，造福更多 React 開發者。 ## [](https://github.com/reactjs/zh-hans.reactjs.org/#關于中文翻譯工作)關于中文翻譯工作： **翻譯流程：** 1. 挑選你想要翻譯或校對的文章[New Chinese Website: TODOs](https://github.com/reactjs/zh-hans.reactjs.org/issues/4) 2. 請 fork 這個倉庫 3. 基于 fork 后的倉庫中 main 分支拉取一個新的分支（名字自取） 4. 翻譯(校對)你所選擇的文章，提交到新的分支 5. 此時提交 Pull Request 到該倉庫 6. 會有專人 Review 該 Pull Request，當兩人以上通過該 Pull Request 時，你的翻譯將被合并到倉庫中 7. 刪除你所創建的分支（如繼續參與，參考同步流程） **同步流程：** 1. 添加該 repo 為你 fork 后倉庫上游 ~~~ $ git remote add upstream git@github.com:reactjs/zh-hans.reactjs.org.git or $ git remote add upstream https://github.com/reactjs/zh-hans.reactjs.org.git ~~~ 2. 同步 git fetch 上游代碼 ~~~ $ git checkout main && git fetch upstream ~~~ 3. 將上游代碼合并至你 fork 后的倉庫(main 分支)中，保證你的 main 分支永遠是最新版本 ~~~ $ git merge upstream/main ~~~ 4. 重復翻譯流程 > 注意： > > 1. 同步時不應產生 Merge 相關的 commit > 2. 盡量保證一次 PR 只有一篇文章，便于后續校對和維護 **詞匯表（[Glossary](https://github.com/reactjs/zh-hans.reactjs.org/issues/2)）：** 大家在翻譯過程中會遇到不需要翻譯的內容，可以添加到詞匯表中。 項目起步，部分內容逐步完善中。后續會添加相關流程圖片，便于理解。 該流程我繼續細化，如有疑問。