The following presentation and video is from the August 2017 CAB call and gives more quick overview of this project, short demo, and its goals. This blog published on the Cloud Foundry site gives a thorough overview of the motivation, overview, and getting started primer for
cf-extensions periodically runs (daily) to discover new CF-Extensions project and engage with them in a small workflow to collect metadata. With collected metadata and official status information, the bot dynamically generates curated lists of the projects with information useful to the CF community.
The following diagram summarizes the work done by the
cf-extensions bot each time it runs.
The resulting summary list of extensions created in the
docs folder is accessible from either pointing your browser to:
cloudfoundry-incubator/cf-extensions/docs/index.md or eventually from
Getting Started: a primer
In order to be listed as a CF-Extensions project, instigators need to follow the following steps:
- Make their repos public.
- If the repo is not part of one of the the CFF’s supported organizations, then move it to
- Modify their GitHub topics list to include
- Next time the cf-extensions bot runs it will submit an issue to your repo with instructions to create a
.cf-extensionsJSON or YAML metadata file and what values to include.
Once you are ready to submit your proposal extension to the CF-Extensions PMC then follow these additional steps:
- Read through the CF-Extensions process .
- Create a CF-Extensions proposal following the template .
- Submit proposal to
- Take part in the monthly CF-Extensions PMC calls .
During all these steps, you are welcome to contact
email@example.com if you have any questions. Once a proposal is submitted and accepted, it’s status will move from “Unknown” to “Proposed” and the project will automatically move from the untracked database to the tracked database and be added to the catalog of managed CF-Extensions projects.
It’s important to note that the CF-Extensions process is self-driven. That is, each proposer/instigator can chose to move projects through the process as fast (within some limits) or as slow as they chose. A project can also be retracted at any time.
Conclusion: how to contribute and future
The CF-Extensions GitHub bot was created out of the need to reduce this logistical burden in keeping lists of GitHub projects in syncing with the community. By requiring extensions instigators to tag (add topic in GitHub) their projects and provide a little bit of metadata, we are able to dynamically construct an accurate list of all extensions to CloudFoundry and organize this list.
Some future features may include but are not limited to:
- Providing different views of the tracked and untracked projects databases.
- Expanding the search of the
cf-extensionsbot to all organizations that are part of the CFF.
- Generating emails to
cf-devmailing list to communicate new proposed extensions to the community along with when their statuses have changed.
If you would like to participate in maintaining and improving the CF-Extensions GitHub bot project , which itself is added as an extension (tool category with distributed commit), we welcome you to clone and peruse the code. All pull requests as well as issues and suggestions and bug reports are encouraged.