| <?xml version="1.0" encoding="UTF-8"?> |
| <!-- |
| ==================================================================== |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| ==================================================================== |
| --> |
| <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "document-v20.dtd"> |
| |
| <document> |
| <header> |
| <title>Apache POI™ - Source Code Repository</title> |
| <authors> |
| <person id="NB" name="Nick Burch" email="dev@poi.apache.org"/> |
| </authors> |
| </header> |
| |
| <body> |
| <section><title>Download the Source</title> |
| <p> |
| Most users of the source code probably don't need to have day to |
| day access to the source code as it changes. Therefore most users will want |
| to make use of our <a href="site:download">source release</a> |
| packages, which contain the complete source tree for each binary |
| release, suitable for browsing or debugging. These source releases |
| are available from our |
| <a href="site:download">download page.</a> |
| </p> |
| <p> |
| The Apache POI source code is also available as source artifacts |
| in the <a href="https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.apache.poi%22">Maven Central repository</a>, |
| which may be helpful for those users who make use of POI via Maven |
| and wish to inspect the source (eg when debugging in an IDE). |
| </p> |
| </section> |
| <section><title>Access the Version Controlled Source Code</title> |
| <p>Apache POI uses Git as its version control system. We switched from Subversion to Git |
| in July 2025. |
| </p> |
| |
| <ul> |
| <li>For access to the latest Apache POI code, please use |
| <a href="https://github.com/apache/poi/tree/trunk/">https://github.com/apache/poi/tree/trunk/</a></li> |
| </ul> |
| |
| <p>If you are not a <em>Committer</em>, but you want to submit patches |
| or even request commit privileges, please see our |
| <a href="site:guidelines">Contribution Guidelines</a> for more |
| information.</p> |
| </section> |
| <section><title>Git access to POI sources</title> |
| <p> |
| The trunk source repository for Apache POI is in gitbox.apache.org. |
| The GitHub mirror can be used to access the repo too (https://github.com/apache/poi). |
| You can create PRs and issues using GitHub, if you like. |
| </p> |
| </section> |
| <section><title>Code metrics</title> |
| <p> |
| Code quality reports for Apache POI are available on the |
| <a href="https://sonarcloud.io/dashboard?id=poi-parent">Apache Sonar instance</a>. |
| </p> |
| <p> |
| Sonar provides lots of useful numbers and statistics, especially |
| watching the project over time shows how some of the indicators evolve |
| and allows to see which areas need some polishing. |
| </p> |
| </section> |
| </body> |
| <footer> |
| <legal> |
| Copyright (c) @year@ The Apache Software Foundation. All rights reserved. |
| <br /> |
| Apache POI, POI, Apache, the Apache logo, and the Apache |
| POI project logo are trademarks of The Apache Software Foundation. |
| </legal> |
| </footer> |
| </document> |
