Documentation-Patch Submission For Apache Issues
Join the DZone community and get the full member experience.
Join For FreeThe following piece is authored by: Pushpalanka
Submitting a patch
for a documentation issue is same as submitting a patch for a code
issue. Only thing to be noticed is where the source code for sites
resides. Here I am sharing the steps in a very basic level as helpful
for a beginner, from identifying an issue to the submission of patch.
Note:The
sample commands I am using here are for linux and for other
environments the relevant commands should be applied for same
functionality.
- After identifying the issue from Apache issue navigator, check out the relevant files directory from apache SVN.
- Navigate to the relevant .xml files and do the improvements or corrections needed and make sure the xml validation is done and the document is presented as it is intended to be.
- Lets see how the changes are applying. In the top level directory that includes all the changes and improvements enter the following command.
eg: svn diff -x-p
You will see something as follows,
- lines preceded with - are to be deleted
- lines preceded with + are to be added
- Make sure those are the intended changes and then create the patch with the following command:
eg: svn diff >AXIS2-4655.patch
- Now submit the patch at the jira issue page as follows and add any meaningful comments.

Keep in touch for updates on the patch submitted. Keep contributing.
Published at DZone with permission of Will Soprano. See the original article here.
Opinions expressed by DZone contributors are their own.
Comments