Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs/docsite/rst/community/advanced_index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,12 @@
Advanced Contributor Guide
**********************************************

This guide focuses on contributors who are committers, GitHub admins, or release managers.
This guide focuses on contributors who are committers, GitHub admins, release managers, or Ansible ecosystem project developers.

.. toctree::
:maxdepth: 1

committer_guidelines
release_managers
github_admins
ecosystem_project_resources
41 changes: 41 additions & 0 deletions docs/docsite/rst/community/ecosystem_project_resources.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
.. _ecosystem_project_dev_resources:

***********************************************
Ansible Ecosystem Project Development Resources
***********************************************

This document lists resources to help contributors interested in developing a community project in the `Ansible ecosystem <https://docs.ansible.com/ecosystem.html>`_.

.. note::

Any improvements to the resources listed in this document or to the document itself are very welcome! Please submit an issue or pull request in the corresponding GitHub repository.

.. _onboarding_toolkit:

Onboarding toolkit
==================

The `Ansible Onboarding toolkit <https://ansible.readthedocs.io/projects/project-onboarding/en/latest/>`_ provides guidelines on setting up GitHub repositories for new projects as well as the type of documentation your project should include.

Despite being originally developed for Ansible ecosystem projects under the ``ansible-community`` GitHub organization, everyone is welcome to use the onboarding toolkit.

Project template
================

The `Ansible project-template <https://github.com/ansible-community/project-template>`_ is a GitHub repository template for Ansible ecosystem projects that contains:

* Files normally present in every repository such as README, license, code of conduct, and so on.
* A docsite template that you are encouraged to use with your project to provide a consistent experience across the Ansible project ecosystem.

Please take a look at the `docsite <https://ansible.readthedocs.io/projects/ansible-project-template/en/latest/>`_ built from the project-template to see it in action.

You are welcome to take the template, fill in your project-specific information, build it using `Sphinx <https://www.sphinx-doc.org/en/master/>`_, and then publish it.

Even if your project is not new and already has documentation, we recommend you take a look at the template and check if there is anything missed in documentation for your project users, contributors, and maintainers.

List of community-curated projects
==================================

Whether your project repository is under the ``ansible-community`` GitHub organization or under your own one, you are welcome to include your project in the `Awesome Ansible list <https://github.com/ansible-community/awesome-ansible/blob/main/README.md>`_.

Before letting the community know about your shiny project by adding it to the list, make sure it satisfies the standards explained in the :ref:`onboarding_toolkit` to provide the best user and contributor experience.