:orphan:

.. _community:

Community
=========

pycsw is `used`_ in government, academia and industry, both as a standalone and embedded component in geospatial data portal applications.

.. include:: ../build/map.rst

.. image:: ../_static/usgs-cida.jpg
   :width: 150px
   :height: 84px
   :alt: USGS Center for Integrated Data Analytics
   :target: http://cida.usgs.gov
   :class: padded

.. image:: ../_static/geonode.jpg
   :width: 162px
   :height: 56px
   :alt: GeoNode
   :target: http://geonode.org
   :class: padded

.. image:: ../_static/sopac.jpg
   :width: 139px
   :height: 80px
   :alt: Secretariat of the Pacific Community
   :target: http://www.sopac.org
   :class: padded

.. image:: ../_static/inside-idaho.jpg
   :width: 76px
   :height: 80px
   :alt: INSIDE Idaho
   :target: http://insideidaho.org
   :class: padded

|

.. image:: ../_static/ogc-chisp.jpg
   :width: 108px 
   :height: 81px
   :alt: OGC Climate-Hydrologic Information Sharing Pilot 
   :target: http://www.opengeospatial.org/projects/initiatives/chisp
   :class: padded

.. image:: ../_static/open-data-catalog.png
   :width: 240px
   :height: 91px
   :alt: Open Data Catalog, Code for America Brigade
   :target: http://commons.codeforamerica.org/apps/open-data-catalog
   :class: padded

.. image:: ../_static/uni-koeln.png
   :height: 77px
   :width: 77px
   :alt: University of Cologne, Department of Geography, Collaborative Research Centre 806
   :target: http://crc806db.uni-koeln.de/
   :class: padded



There are numerous ways to interact with the pycsw community.

Google+
-------

pycsw exists as a `Google+ community`_.  Join us there for pycsw news discussion, and more.

FAQ
---

The :ref:`faq` provides answers to commonly asked questions about pycsw.

Mailing List
------------

The pycsw-devel mailing list enables users and developers to exchange ideas, discuss improvements / issues, and ask questions. To subscribe, visit http://lists.osgeo.org/mailman/listinfo/pycsw-devel.

Mailing list archives are available at http://lists.osgeo.org/pipermail/pycsw-devel.  The mailing list is also available/searchable via the OSGeo `Nabble`_ forum.

IRC
---

Internet Relay Chat (IRC) allows for real-time communication and group discussion.  The pycsw IRC channel can be found at:

- **Server**: ``irc.freenode.net``
- **Channel**: ``#pycsw`` (or ``#geopython``)
- **Port**: ``6667``

pycsw developers can be found in the IRC channel.  Below are some suggested IRC clients:

- `Chatzilla`_ (Firefox)
- `Colloquy`_ (Mac OS)
- `irssi`_ (Terminal-based)

Service Providers
-----------------

pycsw service providers (core development, support, training) can be found on the `OSGeo Service Provider Directory <http://www.osgeo.org/search_profile?SET=1&MUL_TECH[]=00107>`_.

GitHub (Wiki, Issues, Code)
---------------------------

The pycsw `wiki`_ provides an area for supporting information that frequently changes and / or is outside the scope of the formal documentation.
 
pycsw's `issue tracker`_ is the place to report bugs or request enhancements.  To submit a `bug`_ be sure to specify the version you are using, the appropriate component, a description of how to reproduce the bug, as well as what version of Python and platform.  For convenience, you can run ``sbin/pycsw-admin.py -c get_sysprof`` and copy/paste the output into your bug report.

GitHub provides the ability for users to issue `pull requests`_, and is the preferred way to have your contributions added to pycsw, although patches and other mechanisms are welcome as well.  If you are submitting a patch, please add the ``has-patch`` label to the ticket (so tickets with patches can be easily filtered).  Also read the :ref:`faq` before submitting.

All pycsw `source code`_ is managed on GitHub, which includes the latest (``master``) and other supported branches.

Getting Involved
----------------

Users, developers and others are more than welcome!  There are plenty of ways to get involved:

- Developers (check :ref:`development` for more info)

 - adding new functionality
 - fixing issues
 - adding unit tests

- Users

 - reporting bugs
 - testing
 - documentation




.. _`Google+ community`: https://plus.google.com/communities/104084873011085696113
.. _`bug`: https://github.com/geopython/pycsw/issues/new
.. _`used`: https://github.com/geopython/pycsw/wiki/Live-Deployments
.. _`pull requests`: https://help.github.com/articles/creating-a-pull-request
.. _`Nabble`: http://osgeo-org.1560.x6.nabble.com/pycsw-devel-f5055821.html
.. _`Chatzilla`: http://chatzilla.hacksrus.com/
.. _`Colloquy`: http://colloquy.info/
.. _`irssi`: http://irssi.org/
.. _`wiki`: https://github.com/geopython/pycsw/wiki
.. _`issue tracker`: https://github.com/geopython/pycsw/issues
.. _`source code`: https://github.com/geopython/pycsw
