Difference between revisions of "Simple Pull Request"

From GnuCash
Jump to: navigation, search
m (Layout)
(only new translations)
Line 1: Line 1:
 
It is possible to create simple '''pull requests''' ('''PR''') using GitHubs web interface without setting up a local Git repository.
 
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.
 
;Requirements: Only a web browser.
;Use Cases: You want to fix a typo, upload a translation, ...
+
;Use Cases: You want to fix a typo, upload a new translation<ref>For updates of existing translations please use [{{URL:wl}} Weblate] to avoid conflicts.</ref>, ...
 
;Downside: To update your fork, you have to delete it (if there are no open PRs) and fork it again.
 
;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]].
 
For more complex cases see [[Setup for Pull Requests]].
Line 14: Line 14:
 
#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 is merged (or closed for other reasons) you can remove your fork or branch.
 
#After the PR is merged (or closed for other reasons) you can remove your fork or branch.
 +
 +
==Notes, References==
 +
<references/>

Revision as of 09:26, 14 August 2022

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 new translation[1], ...
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.
  2. Open the desired Gnucash or finance-quote repository file you want to change.
  3. 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.
  4. GitHub will create a copy of the repository (actually a branch) in your account. Click the Create pull request button.
  5. Give the Pull Request a description and add any comments then click Create pull request button.
  6. Wait for comments and apply potential change requests by the core developers.
  7. After the PR is merged (or closed for other reasons) you can remove your fork or branch.

Notes, References

  1. For updates of existing translations please use Weblate to avoid conflicts.