Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
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
35 changes: 35 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# CODEOWNERS file for PINA

# The default owners for everything in the repo
# (Pull requests touching any file in "/" will require review from at least one of these)
* @mathLab/pina-developers
pina/ @mathLab/pina-developers
readme/ @mathLab/pina-developers
tests/ @mathLab/pina-developers
tutorials/ @mathLab/pina-developers
pyproject.toml @mathLab/pina-developers @ndem0

# Owners for documentation
docs/ @mathLab/pina-developers @dario-coscia

# Owners for JOSS
joss/ @ndem0 @annaivagnes @dario-coscia

# Owners for project-wide config (GitHub workflows, formatting, etc.)
.github/ @ndem0 @dario-coscia
.gitattributes @ndem0 @dario-coscia
.gitignore @ndem0 @dario-coscia

# Security & policy files
CITATION.cff @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
CONTRIBUTING.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
LICENSE.rst @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
SECURITY.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
CODE_OF_CONDUCT.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
MAINTAINERS.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
ANTITRUST.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
CHARTER.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
GOVERNANCE.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
STEERING-COMMITTEE.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
TRADEMARKS.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
utils @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
8 changes: 8 additions & 0 deletions ANTITRUST.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Antitrust Policy

Participants acknowledge that they may compete with other participants in various lines of business and that it is therefore imperative that they and their respective representatives act in a manner that does not violate any applicable antitrust laws, competition laws, or associated regulations. This Policy does not restrict any participant from engaging in other similar projects. Each participant may design, develop, manufacture, acquire or market competitive deliverables, products, and services, and conduct its business, in whatever way it chooses. No participant is obligated to announce or market any products or services. Without limiting the generality of the foregoing, participants agree not to have any discussion relating to any product pricing, methods or channels of product distribution, contracts with third-parties, division or allocation of markets, geographic territories, or customers, or any other topic that relates in any way to limiting or lessening fair competition.

---
## Attribution
This file is adapted from the [Minimum Viable Governance][https://github.com/github/MVG],
homepage, Licensed under the [CC-BY 4.0 License](https://creativecommons.org/licenses/by/4.0/).
71 changes: 71 additions & 0 deletions CHARTER.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
# Charter for the PINA Organization

This is the organizational charter for the PINA Organization. In this Charter and related documents, “PINA Organization” means the entity designated in this Charter as the governing body of the PINA project. At the time of writing, this is the PINA Steering Committee. If governance changes in the future, references to “PINA Organization” automatically refer to the successor entity named here without rewriting other policies. By adding their name to the [Steering Committee.md file](https://github.com/mathLab/PINA/blob/master/STEERING-COMMITTEE.md), Steering Committee members agree as follows.

## 1. Mission

PINA mission is to advance open, accessible, and reliable computational tools that bridge mathematics, data, and real-world applications using Machine Learning. We strive to:

Empower researchers, educators, and practitioners with robust, transparent, and well-documented frameworks for scientific discovery.

Accelerate innovation by integrating classical mathematical methods with modern computational machine learning-based techniques.

Promote collaboration and openness by maintaining a community-driven platform built on principles of reproducibility, interoperability, and long-term sustainability.

By pursuing these goals, the Organization aims to be a cornerstone resource in computational mathematics, supporting both theoretical advances and impactful applications across disciplines.


## 2. Steering Committee

**2.1 Purpose**. The Steering Committee will be responsible for all technical oversight, project approval and oversight, policy oversight, and trademark management.

**2.2 Composition**. The Steering Committee voting members are listed in the [STEERING-COMMITEE.md](https://github.com/mathLab/PINA/blob/master/STEERING-COMMITTEE.md) file in the repository.
Voting members may be added or removed by no less than 75% affirmative vote of the Steering Committee.
The Steering Committee will appoint a Chair responsible for organizing Steering Committee activity.

## 3. Voting

**3.1. Decision Making**. The Steering Committee will strive for all decisions to be made by consensus. While explicit agreement of the entire Steering Committee is preferred, it is not required for consensus. Rather, the Steering Committee will determine consensus based on their good faith consideration of a number of factors, including the dominant view of the Steering Committee and nature of support and objections. The Steering Committee will document evidence of consensus in accordance with these requirements. If consensus cannot be reached, the Steering Committee will make the decision by a vote.

**3.2. Voting**. The Steering Committee Chair will call a vote with reasonable notice to the Steering Committee, setting out a discussion period and a separate voting period. Any discussion may be conducted in person or electronically by text, voice, or video. The discussion will be open to the public. In any vote, each voting representative will have one vote. Except as specifically noted elsewhere in this Charter, decisions by vote require a simple majority vote of all voting members.

## 4. Termination of Membership

In addition to the method set out in section 2.2, the membership of a Steering Committee member will terminate if any of the following occur:

**4.1 Resignation**. Written notice of resignation to the Steering Committee.

**4.2 Unreachable Member**. If a member is unresponsive at its listed handle for more than three months the Steering Committee may vote to remove the member.

## 5. Trademarks

Any names, trademarks, service marks, logos, mascots, or similar indicators of source or origin and the goodwill associated with them arising out of the PINA's activities or PINA projects' activities (the "Marks"), are controlled by the PINA Organization. PINA Marks may be only used in accordance with the [trademark policy](https://github.com/mathLab/PINA/blob/master/TRADEMARKS.md).

## 6. Antitrust Policy

The Steering Committee is bound by the [antitrust policy](https://github.com/mathLab/PINA/blob/master/ANTITRUST.md).

## 7. No Confidentiality

Information disclosed in connection with any of the PINA's activities, including but not limited to meetings, contributions, and submissions, is not confidential, regardless of any markings or statements to the contrary.

## 8. Project Criteria

In order to be eligible to be a PINA project, a project must:

* Be approved by the Steering Committee.
* Agree to follow the guidance and direction of the Steering Committee.
* Use only the following outbound licenses or agreements unless otherwise approved:
- For code, a license on the Open Source Initiative's list of [Popular Licenses](https://opensource.org/licenses).
- For data, a license on the Open Knowledge Foundation's list of [Recommended Conformant Licenses](http://opendefinition.org/licenses/).
- For specifications, a community developed and maintained specification agreement, such the [Open Web Foundation Agreements](https://www.openwebfoundation.org/the-agreements) or [Community Specification Agreement](https://github.com/CommunitySpecification/1.0).
* Include and adhere to the PINA's policies, including the [trademark policy](https://github.com/mathLab/PINA/blob/master/TRADEMARKS.md), the [antitrust policy](https://github.com/mathLab/PINA/blob/master/ANTITRUST.md), and the [code of conduct](https://github.com/mathLab/PINA/blob/master/CODE_OF_CONDUCT.md).

## 9. Amendments

Amendments to this charter, the [antitrust policy](https://github.com/mathLab/PINA/blob/master/ANTITRUST.md), the [trademark policy](https://github.com/mathLab/PINA/blob/master/TRADEMARKS.md), or the [code of conduct](https://github.com/mathLab/PINA/blob/master/CODE_OF_CONDUCT.md) may only be made with at least a 75% affirmative vote of the Steering Committee.

---
## Attribution
This file is adapted from the [Minimum Viable Governance][https://github.com/github/MVG],
homepage, Licensed under the [CC-BY 4.0 License](https://creativecommons.org/licenses/by/4.0/).
48 changes: 48 additions & 0 deletions GOVERNANCE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# Governance Policy

This document provides the governance policy for the PINA. Maintainers agree to this policy and to abide by all PINA polices, including the [code of conduct](https://github.com/mathLab/PINA/blob/master/CODE_OF_CONDUCT.md), [trademark policy](https://github.com/mathLab/PINA/blob/master/TRADEMARKS.md), and [antitrust policy](https://github.com/mathLab/PINA/blob/master/ANTITRUST.md) by adding their name to the [maintainers.md file](https://github.com/mathLab/PINA/blob/master/MAINTAINERS.md).

## 1. Roles.

This project may include the following roles. Additional roles may be adopted and documented by the Project.

**1.1. PINA Organization**. The PINA Organization provides strategic and policy stewardship, manages project assets (including Marks as defined in the trademark policy), resolves escalations, and approves changes to governance and charter documents.

**1.2. Maintainers**. Maintainers are responsible for organizing activities around developing, maintaining, and updating the project. Maintainers are also responsible for determining consensus. Maintainers may be added or removed with the approval of the current Maintainers.

**1.3. Contributors**. Contributors are those who make contributions to the project (e.g., code, documentation, issues, reviews).

## 2. Decisions.

**2.1. Consensus-Based Decision Making**. The project seeks consensus of the Maintainers. While explicit agreement of all Maintainers is preferred, it is not required. Maintainers will determine consensus based on good-faith consideration of factors including the dominant view of Contributors and the nature of support and objections. Evidence of consensus should be documented (e.g., via issues/PRs, meeting notes).

**2.2. Appeal Process**. Project decisions may be appealed by opening an issue. Maintainers will consider the appeal in good faith and respond in writing within a reasonable time. If the Maintainers deny the appeal, it may be escalated to the PINA Organization, which will also respond in writing within a reasonable time.

## 3. How We Work.

**3.1. Openness**. Participation is open to anyone who is directly and materially affected by the activity in question. There shall be no undue financial barriers to participation.

**3.2. Balance**. The development process should balance the interests of Contributors and other stakeholders. Contributors from diverse interest categories shall be sought with the objective of achieving balance.

**3.3. Coordination and Harmonization**. Good faith efforts shall be made to resolve potential conflicts or incompatibility between releases in this Project.

**3.4. Consideration of Views and Objections**. Prompt consideration shall be given to the written views and objections of all Contributors.

**3.5. Written procedures**. This governance document and other materials documenting this project's development process shall be available to any interested person.

## 4. No Confidentiality.

Information disclosed in connection with any Project activity, including but not limited to meetings, contributions, and submissions, is not confidential, regardless of any markings or statements to the contrary.

## 5. Trademarks.

Any names, trademarks, logos, or goodwill developed by and associated with the project (the “Marks”) are controlled by the PINA Organization. Maintainers and Contributors may only use these Marks in accordance with the project’s (trademark policy)[].

## 6. Amendments.

Amendments to this governance policy may be made by affirmative vote of 2/3 of all Maintainers, with approval by the Organization's Steering Committee.

---
## Attribution
This file is adapted from the [Minimum Viable Governance][https://github.com/github/MVG],
homepage, Licensed under the [CC-BY 4.0 License](https://creativecommons.org/licenses/by/4.0/).
22 changes: 22 additions & 0 deletions MAINTAINERS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Maintainers List

# Maintainers

This document lists the Maintainers of the Project. Maintainers may be added once approved by the existing maintainers as described in the [Governance document](https://github.com/mathLab/PINA/blob/master/GOVERNANCE.md). By adding your name to this list you are agreeing to abide by the Project governance documents and to abide by all of the Organization's polices, including the [code of conduct](https://github.com/mathLab/PINA/blob/master/CODE_OF_CONDUCT.md), [trademark policy](https://github.com/mathLab/PINA/blob/master/TRADEMARKS.md), and [antitrust policy](https://github.com/mathLab/PINA/blob/master/ANTITRUST.md). If you are participating because of your affiliation with another organization (designated below), you represent that you have the authority to bind that organization to these policies.


| **GithubID** | **Email Address** | **Organization** |
| ------------ | ------------------------ | ---------------------- |
| @GiovanniCanali | giovanni.canali98@yahoo.it | SISSA |
| @dario-coscia | dariocos99@gmail.com | SISSA |
| @ndem0 | demo.nicola@gmail.com | SISSA - FAST COMPUTING SRL |
| @AleDinve | gdinvern@sissa.it | SISSA |
| @annaivagnes | aivagnes@sissa.it | SISSA |
| @FilippoOlivo | filippo@filippoolivo.com | SISSA - FAST COMPUTING SRL |
| @guglielmopadula | gpadula@sissa.it | SISSA |
| @fpichi | fpichi@sissa.it | SISSA |

---
## Attribution
This file is adapted from the [Minimum Viable Governance][https://github.com/github/MVG],
homepage, Licensed under the [CC-BY 4.0 License](https://creativecommons.org/licenses/by/4.0/).
15 changes: 15 additions & 0 deletions STEERING-COMMITTEE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Steering Committee

This document lists the members of the Organization's Steering Committee (in alphabetical order). Voting members may be added once approved by the Steering Committee as described in the [charter](github.com/mathLab/PINA/blob/master/CHARTER.md). By adding your name to this list you are agreeing to abide by all Organization polices, including the [charter](github.com/mathLab/PINA/blob/master/CHARTER.md), the [code of conduct](https://github.com/mathLab/PINA/blob/master/CODE_OF_CONDUCT.md), the [trademark policy](https://github.com/mathLab/PINA/blob/master/TRADEMARKS.md), and the [antitrust policy](https://github.com/mathLab/PINA/blob/master/ANTITRUST.md). If you are serving on the Steering Committee because of your affiliation with another organization (designated below), you represent that you have authority to bind that organization to these policies.

| **NAME** | **Handle** | **Affiliated Organization** |
| ------------ | ------------ | --------------------------- |
| Giovanni Canali | @GiovanniCanali | SISSA |
| Dario Coscia | @dario-coscia | SISSA |
| Nicola Demo | @ndem0 | SISSA - FAST COMPUTING SRL |
| Filippo Olivo | @FilippoOlivo | SISSA - FAST COMPUTING SRL |

---
## Attribution
This file is adapted from the [Minimum Viable Governance][https://github.com/github/MVG],
homepage, Licensed under the [CC-BY 4.0 License](https://creativecommons.org/licenses/by/4.0/).
Loading
Loading