Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

Documentation-Patch Submission For Apache Issues

DZone's Guide to

Documentation-Patch Submission For Apache Issues

· Integration Zone ·
Free Resource

SnapLogic is the leading self-service enterprise-grade integration platform. Download the 2018 GartnerMagic Quadrant for Enterprise iPaaS or play around on the platform, risk free, for 30 days.

 The 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.
       eg :  svn co  http://svn.apache.org/repos/asf/axis/axis2/java/core/trunk/src/site/xdoc/
  • 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:
            svn diff ><the preferred name for patch file>
            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.

With SnapLogic’s integration platform you can save millions of dollars, increase integrator productivity by 5X, and reduce integration time to value by 90%. Sign up for our risk-free 30-day trial!

Topics:

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}