src/site/apt/get-involved.apt

~~ ====================================================================
~~ 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.
~~ ====================================================================
~~ 
~~ This software consists of voluntary contributions made by many
~~ individuals on behalf of the Apache Software Foundation.  For more
~~ information on the Apache Software Foundation, please see
~~ <http://www.apache.org/>.

   -----------
   Get Involved With HttpComponents

Community

   * Users mailing list: {{{mailto:httpclient-users@hc.apache.org}httpclient-users@}} for general discussion, questions, and announcements. This is the perfect place to ask for help if you need it!

   * Development mailing list: {{{mailto:dev@hc.apache.org}dev@}} for discussion about project development.
   
   * GitHub: Star us at {{{https://github.com/apache/httpcomponents-core/}apache/httpcomponents-core}} and {{{https://github.com/apache/httpcomponents-client/}apache/httpcomponents-client}} and use this to follow HttpComponents development or contribute pull requests. If you're interested in development, please see the Contributing section below for details on our development process.
   
   * Reporting issues:
      
      * {{{https://issues.apache.org/jira/projects/HTTPCORE}HttpComponents Core}}
      
      * {{{https://issues.apache.org/jira/projects/HTTPCLIENT}HttpComponents Client}} and {{{https://issues.apache.org/jira/projects/HTTPASYNC}HttpComponents AsyncClient}}
   
   * Slack: Some committers and users are present in the channel {{{https://the-asf.slack.com/archives/CGC9KPJKH}#httpcomponents-client}} on the Apache Slack team.
   
   * StackOverflow: While the user mailing list is the primary resource for asking questions, if you prefer StackOverflow, make sure to tag your question with {{{https://stackoverflow.com/questions/tagged/apache-httpcomponents}apache-httpcomponents}}.

Contributing

   HttpComponents is a community-led project and we are delighted to receive contributions of anything from minor fixes to new features.
   If you have an itch to scratch, then by all means do that! Fixing bugs you run into, or adding features you need, are both immensely helpful.
   There are plenty of ways to help outside writing code. Code review of pull requests (even if you are not a committer), feature suggestions, reporting bugs, documentation and usability feedback all matter immensely.

Testing

   All Pull Requests are automatically tested on {{{https://travis-ci.com/apache/httpcomponents-core}Travis CI (Core)}}, {{{https://travis-ci.com/apache/httpcomponents-client}Travis CI (Client)}} on both AMD64 and ARM64 architectures.

More information

   As it happens, the ways to get involved into an open source project are basically the same for all projects.
   Please have a look at the {{{http://incubator.apache.org/guides/participation.html}Incubator Guide To Participation}}.
   It's terse, but has pointers to additional information elsewhere at Apache.
   The sections on participating as a User and as a Developer apply here, too.