XSLTForms/Contributing Code

From Wikibooks, open books for an open world
Jump to navigation Jump to search

The XSLTForms project has over its history moved through several source-code repositories. A Web search will find multiple SourceForge and GitHub repositories for the project.

Note: The original plan for this book was to populate the two pages linked from the table of contents with the titles XSLT 1.0 stylesheet - Templates and Javascript - Classes and Functions with auto-generated documentation for the xsltforms.xsl and xsltforms.js; as may be seen from the page histories, the Javascript documentation was auto-generated in 2010 and the XSLT documentation has never been generated. A new plan for providing documentation for would-be contributors may be needed.

Active repository[edit]

Currently (February 2017), active development takes place in a GitHub repository called xphoneforms; builds can be obtained from the repositories named xsltforms on GitHub and SourceForge but these are currently just copies from the development repository.

Proposing changes[edit]

Currently (February 2017), the best way to propose changes to XSLTForms is probably to use GitHub's 'pull request' feature:

  1. Fork the xphoneforms repository.
  2. Make your changes in your forked copy.
  3. Test them.
  4. Use the GitHub Make pull request button to create a pull request for the main repository which includes the changes you want to propose.

Note that the directory /src/js contains both an xsltforms.js and an xsltforms2.js subdirectory. If you are proposing changes to the current XSLTForms, there is no need to make changes in the latter: the two directories will be synchronized when required.