Skip to content

A ✨special✨ repository: org-level default metadata & community health files for use across all OpenINF projects on GitHub

Notifications You must be signed in to change notification settings

OpenINF/.github

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenINF logo

.github Stars

Org-level default metadata & community health files


'View on npm (coming soon)' 'License: MIT/Apache-2.0'


The OpenINF .github repository is a one-stop shop for default metadata and community health files for all @OpenINF projects on GitHub. If a file does not exist for a specific project, these organization-wide defaults will be used. We are constantly working to improve this repository, so please feel free to contribute if you notice any omissions or errors.

Thanks!


Code Style: Prettier Chat on Matrix





Contents

  1. Cascading Metadata & Community Health Files
  2. Local Metadata & Community Health Files
  3. Contributing
  4. License






Info

While these files themselves won't appear in the file browser or Git history of each repository, they will be surfaced throughout developers' workflows, such as when opening a new issue or when viewing the project's Community Profile, just as if it were committed to the repository directly.1


File name Title Description
CODE_OF_CONDUCT.md Code of Conduct Defines standards for how to engage in a community
CONTRIBUTING.md Contribution Guidelines Communicates how people should contribute to a project
FUNDING.yml Funding Displays a sponsor button per repository increasing visibility of project funding options
ISSUE_TEMPLATE and PULL_REQUEST_TEMPLATE Issue and PR templates customize and standardize information contributors are to include when opening issues and PRs
SECURITY.md Security Policy Gives instructions for how to report a security vulnerability in a project
SUPPORT.md Support Resources Lets people know about ways to get help with a project


Issue

We cannot create organization-wide defaults for the following files as they are often unique per project. Therefore, they must be added to each individual repository so that they will be included when the project is cloned, packaged, or downloaded. Refer to the ones contained in this repository for guidance on how these files are expected to look.


File name Title Description
AUTHORS The OpenINF Authors Lists the contributors of their respective project repositories23
README.md Homepage Serves as a project landing page of sorts
/LICENSE/ Software License(s) The open-source software license(s) associated with a project
VISION.md Project Vision The goal(s) and/or scope of a project

Tip

The VISION.md file can be useful for offloading project goals that should typically be specified in the root README.md file. It may optionally exist alongside it as an alternative location to even include project scope as well, but should be linked to from the root README.md file in these cases.





Contributing


Pull requests are welcome. If you plan to make significant changes, please open an issue to discuss the change first. If you notice something that needs fixing but can't do it yourself, please let us know by opening an issue.



License


This project is licensed under either of the following:

at your option.

The SPDX license identifier for this project is MIT OR Apache-2.0 OR BlueOak-1.0.0.







Footnotes

  1. https://github.blog/changelog/2019-02-21-organization-wide-community-health-files

  2. https://docs.npmjs.com/cli/v8/configuring-npm/package-json#default-values

  3. https://opensource.google/documentation/reference/releasing/authors