Project Information

This document provides an overview of the various documents and links that are part of this project's general information:

Mailing Lists

The following English-speaking mailing lists 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.

Please subscribe before posting messages to these lists. If you don't, your messages are likely to be delayed, as we need to moderate them, or maybe even become lost in the flow of spam that we get from non-subscribed senders.

Name Subscribe Unsubscribe Post ASF Archive Other Archives
Users List Subscribe Unsubscribe users at sling.apache.org lists.apache.org www.mail-archive.com
Developers List Subscribe Unsubscribe dev at sling.apache.org lists.apache.org www.mail-archive.com
Commit Events List Subscribe Unsubscribe lists.apache.org www.mail-archive.com

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:

  1. Locally check out the git repository.
  2. Edit the documentation, don't commit.
  3. From the command line git diff > site.patch.

Submit your changes:

  1. Navigate to the Jira issue tracker.
  2. Create an account and/or login.
  3. Create a ticket, enter a description and choose Documentation for Components.
  4. 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:

  1. Navigate to the Apache Sling Site Project Mirror.
  2. Create an account and/or login.
  3. Edit the documentation using the edit icon Fork this project and edit this file.
  4. Once all changes are done click New pull request.
  5. Select base fork:apache/sling-site base:master as the project to push to
- ( Project Information )