Guidelines are various procedures that should be followed. The whole community and the project will benefit by being more consistent, efficient, collaborative, and rewarding.

Background orientation

• Which forum to use for communication: Issue tracker, Slack chat, GitHub pull requests. Some guidelines about when to use each, and some useful tips. The concise list of forums.
• Guidelines for Contributing Code – GitHub Flow, feature branches, pull requests, version numbers, coding style, tests, etc.
• FOLIO Project Contributor License Agreement.
• FOLIO Developer Manual.
• A FOLIO glossary of some terms and technologies used in FOLIO.
• Guidelines for FOLIO issue tracker.
• Search dev.folio.org and other search and report facilities.

See other orientation guides.

Development

• Guidelines for Contributing Code.
• Naming conventions.
• Development, design, and review processes.
• Pull requests checklists.

Development management

• Release procedures.
• Officially Supported Technologies for each upcoming release (also known as Approved Technologies).
• FOLIO Technical Council (TC) and FOLIO Product Council (PC).
• Each FOLIO Development Team has their “Definition of Ready (DoR)” and “Definition of Done (DoD)” to manage the development process.
• Team and module responsibility matrix.
• Create a new FOLIO module and do initial setup.

Other statements and policies

Code of Conduct

Refer to the Wiki FOLIO Code of Conduct.

Acceptable Use Policy

Refer to the Wiki FOLIO Acceptable Use Policy.

Safe Harbor Statement

As an open source project, FOLIO (folio.org) relies on contributions from the community and this includes discovering defects and potential security flaws.

As a result FOLIO may refrain from bringing any legal action against anyone who makes a good faith effort to use or test FOLIO in accordance with our Acceptable Use Policy. More specifically, we may, in our sole discretion, waive any restrictions in our Acceptable Use Policy for the limited purpose of your security research for the betterment of the FOLIO project. This may include any claim under the DMCA for circumventing technological measures to protect the services and applications eligible under this policy.

We understand that FOLIO software will be installed on various organizations’ systems and will be interconnected with third-party systems and services. While we can authorize your research on FOLIO’s systems and services, and promise that FOLIO may refrain from bringing or threatening litigation against you for your efforts under this policy, we cannot authorize efforts on any other organization’s systems or on third-party products or guarantee they won’t pursue legal action against you.

Please contact us at security@folio.org before engaging in conduct that may be inconsistent with or unaddressed by this policy. We reserve the sole right to make the determination of whether a violation of this policy is accidental or in good faith, and proactive contact to us before engaging in any action is a significant factor in that decision. If in doubt, ask us first!

And, you are expected, as always, to comply with all laws applicable to you.