diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml index ffcbe8b537..6654e7153e 100644 --- a/documentation/dev-manual/dev-manual-newbie.xml +++ b/documentation/dev-manual/dev-manual-newbie.xml @@ -495,10 +495,9 @@ - Sometimes you might find it necessary to submit a change or patch to the Yocto Project. - If so, you must follow certain procedures. + When you submit a change or patch to the Yocto Project you must follow certain procedures. In particular, the headers in patches and the commit messages must follow a certain standard. - The general process is the same as described earlier in this section. + The general process is the same as described earlier in this chapter. For complete details on how to create proper commit messages and patch headers see [WRITER NOTE: I need the link to Mark's wiki page here that describes the process.] @@ -511,17 +510,17 @@ Pushing a Change Upstream - The basic flow for pushing a change to an upstream contrib repository is as follows: + The basic flow for pushing a change to an upstream "contrib" Git repository is as follows: - Make your changes in your local repository. + Make your changes in your local Git repository. Stage your commit (or change) by using the git add command. Commit the change by using the git commit - command and push it to an upstream contrib repository. + command and push it to the upstream "contrib" repository. Be sure to provide a commit message that follows the project’s commit standards. Notify the maintainer that you have pushed a change. - You can find detailed information on how to push a change upstream + You can find general Git information on how to push a change upstream here. @@ -534,7 +533,7 @@ If you have a just a few changes you can commit them and then submit them as an email to the maintainer. Here is the general procedure: - Make your changes in your local repository. + Make your changes in your local Git repository. Stage your commit (or change) by using the git add command. Commit the change by using the git commit command. @@ -549,7 +548,7 @@ Be aware that there could be protocols and standards that you need to follow for your particular project. - You can find detailed information on the general process + You can find general Git information for submitting a patch here.