Project Information
This document provides an overview of the various documents and links that are part of this project's general information:
- Community Roles and Processes
- Project Team
- Mailing Lists
- Issue Tracking
- Source Repository
- Continuous Integration
- Project License
- Documentation Repository
Mailing Lists
These are the mailing lists that have been established for this project. For each list, there is a subscribe, unsubscribe, and an archive link.
The Sling Users List is the preferred way of getting help with Sling. However, you can also Ask a Sling question on StackOverflow if you prefer.
| Name | Subscribe | Unsubscribe | Post | Archive | Other Archives |
|---|---|---|---|---|---|
| Sling Users List | Subscribe | Unsubscribe | users at sling.apache.org | lists.apache.org | www.mail-archive.com MarkMail Nabble |
| Sling Developers List | Subscribe | Unsubscribe | dev at sling.apache.org | lists.apache.org | www.mail-archive.com MarkMail Nabble |
| Sling Source Control List | Subscribe | Unsubscribe | lists.apache.org | www.mail-archive.com MarkMail |
Issue Tracking
This project uses JIRA a J2EE-based, issue tracking and project management application. Issues, bugs, and feature requests should be submitted to the following issue tracking system for this project.
The issue tracker can be found at http://issues.apache.org/jira/browse/SLING
Source Repository
This project uses Git to manage its source code. The source code is hosted on the ASF GitBox setup and replicated to Apache organisation on GitHub. As a developer you may push to either GitBox or GitHub. Note however that for GitHub to work you need to set up your GitHub account with two-factor authentication from the main GitBox page.
To check out the Sling source code, see the instructions from Getting and building Sling.
For additional information see Using Git with Sling.
Web Access
The source code can be accessed using either the GitHub or GitBox setup.
To list all modules on GitHub you can use this search query: https://github.com/apache/?q=sling, or see our list of repositories on this website.
Attic / deprecated modules
See Deprecating Sling Modules for how we manage module deprecation.
Continuous Integration
The Sling+Jenkins+Setup wiki page describes the setup that runs Sling builds automatically (triggered by commits) on the ASF's Jenkins instance.
The Sling Monitor page lists jobs that need attention.
The Sling Folder page lists all jobs.
In any case you wish to customize the jenkins build of a module, just add a .sling-module.json at the root of your project, with overriden values listed in Jenkins Sling module descriptor.
Documentation Repository
The documentation website, in fact the very page that you are reading right now, is located at The Apache Sling Site Project. You can contribute without being an official project committer.
Submitting a patch to the Sling Site project
Create a Git patch:
- Locally check out the git repository.
- Edit the documentation, don't commit.
- From the command line
git diff > site.patch.
Submit your changes:
- Navigate to the Jira issue tracker.
- Create an account and/or login.
- Create a ticket, enter a description and choose Documentation for Components.
- Select the ticket, click more, select attach files and attach your Git patch.
Additionally there is a Github hosted Apache Sling Site Project Mirror which can be used to submit changes as well.
Submitting a pull request to the GitHub Sling Site mirror
Create the Pull Request:
- Navigate to the Apache Sling Site Project Mirror.
- Create an account and/or login.
- Edit the documentation using the edit icon Fork this project and edit this file.
- Once all changes are done click New pull request.
- Select base fork:apache/sling-site base:master as the project to push to