Difference between revisions of "Simple Pull Request"

From GnuCash
Jump to: navigation, search
m (Typo)
(Use automated GitHub fork)
Line 7: Line 7:
  
 
==Procedure==
 
==Procedure==
#[https://github.com/join Create a Github account] or [https://github.com/login log in] and use the excellent GitHub Help in the followin steps.
+
#[https://github.com/join Create a Github account] or [https://github.com/login log in] and use the excellent GitHub Help in the following steps.
#Fork the desired [https://github.com/Gnucash Gnucash] or [https://github.com/finance-quote/ finance-quote] repository.
+
 
#Create a new branch in your fork.
+
#Open the desired [https://github.com/Gnucash Gnucash] or [https://github.com/finance-quote/ finance-quote] repository file you want to change.
#Apply your changes in this branch.
+
#Click the '''pencil''' icon on the top right hand side to ''Edit the file in your fork of this project'', search for text near the location, make any edits you want then preview them to confirm. Give the proposed change a description up to 50 characters and optionally an extended description then click the '''Propose file Change''' button.
#Create a PR.
+
#GitHub will create a copy of the repository (actually a branch) in your account. Click the '''Create pull request''' button.
 +
#Give the ''Pull Request'' a description and add any comments then click '''Create pull request''' button.
 
#Wait for comments and apply potential change requests by the core developers.
 
#Wait for comments and apply potential change requests by the core developers.
#After the PR was merged (or closed for other reasons), you can remove the branch.
+
#After the PR is merged (or closed for other reasons) you can remove your fork or branch.

Revision as of 00:19, 26 April 2021

It is possible to create simple pull requests (PR) using GitHubs web interface without setting up a local Git repository.

Requirements
Only a web browser.
Use Cases
You want to fix a typo, upload a translation, ...
Downside
To update your fork, you have to delete it (if there are no open PRs) and fork it again.

For more complex cases see Setup for Pull Requests.

Procedure

  1. Create a Github account or log in and use the excellent GitHub Help in the following steps.
  1. Open the desired Gnucash or finance-quote repository file you want to change.
  2. Click the pencil icon on the top right hand side to Edit the file in your fork of this project, search for text near the location, make any edits you want then preview them to confirm. Give the proposed change a description up to 50 characters and optionally an extended description then click the Propose file Change button.
  3. GitHub will create a copy of the repository (actually a branch) in your account. Click the Create pull request button.
  4. Give the Pull Request a description and add any comments then click Create pull request button.
  5. Wait for comments and apply potential change requests by the core developers.
  6. After the PR is merged (or closed for other reasons) you can remove your fork or branch.