Project approval and public release#

Most of the projects in the Ansys organization expose the functionality of Ansys products. Due to intellectual property reasons, the public release of a PyAnsys library must go through a project approval process.

First step#

To trigger the public release process, project leads must first complete the Release request workflow initiation form.

This form lets the different parties involved in the public release process know that there is a request to release a project. If your intent is to release an Ansys open source project, then continue to the next section.

Approval process#

The approval process is divided into three parts:

Managerial

Ensures that direct managers, general managers, and the chief technology officer are aware of the project and approve it.

Managerial
Legal

Ensures that the project adheres to a legal framework that protects Ansys intellectual property.

Legal
Technical

Ensures that the project complies with Ansys software guidelines and best practices.

Technical

Important

An approval from each of these three parts is required to release a project to the public. Once all approvals are received, a project can be published to the Public PyPI.

When releasing a project to the public, you must perform these tasks:

  • Coordinate with the product line development team, if applicable.

  • Maintain the project by means of fixing bugs and providing support for new releases.

  • Uphold Ansys’ reputation in the open source community.

Once all three approvals have been awarded, project leads must then complete the OSS (Open Source Software) approval request form.

This form serves as a final checklist to verify that all approvals have been processed and to formalize the OSS approval process as a final record. For more information, see Questions asked on the OSS approval request form.

Managerial#

The managerial part of the approval process ensures that the direct manager, general managers, vice presidents, or the chief technology officer are aware of the project’s existence and status.

A project must be classified into one of these categories, determining the number of administrative reviews and approvals needed:

Documentation projects

Documentation projects must have direct manager approval, legal review, and documentation proofing. No source code other than documentation files is allowed.

Tool projects

Tool projects require direct manager and business unit’s general manager approval. No product source code is allowed.

Library projects

Library projects interfacing and wrapping any Ansys products require approval from the direct manager, product line, and the chief technology officer. No product source code is allowed.

Technical#

Technical approval ensures that the project follows the best and latest software development practices. Request a technical review by sending an email to pyansys.core@ansys.com.

The PyAnsys core team performs these checks when performing the technical review of the project:

The project contains the right metadata information.
The project name follows naming conventions.
The project version follows Semantic versioning.
The project author is ANSYS, Inc.
The project maintainer is ANSYS, Inc.
Contact and support information is provided in the project.
The AUTHORS file is present and compliant with legal requirements.
The LICENSE file is present and compliant with legal requirements.
The CONTRIBUTORS.md file is present and contains the project lead and main contributors.
The project is compliant with PyAnsys style guidelines.
The project layout follows the Packaging style guidelines.
Testing guarantees at least 80% code coverage.
The project adheres to the Documentation style guidelines.
The source code docstring examples have been tested.
The documentation examples are presented as a gallery.
The documentation receives the documentation team’s approval.
The package builds properly.
The project uses CI/CD, including all the Required workflows.
The CI/CD pipeline generates project Artifacts.
The GitHub repository is properly secured.
The repository adheres to the General configuration.
Branch protection is enabled.
Tag protection is enabled.
Workflow protection is enabled.

Questions asked on the OSS approval request form#

When completing the OSS approval request form, project leads must supply responses to several types of questions:

General questions
  • What is the name of your project?

  • Who is the project maintainer?

  • Who is the lead from the product team?

  • Who is the Product Management contact?

  • Who is the ACE/AFT owner?

Legal questions
  • Who validated your legal readiness?

  • Provided there are no issues with the MIT license, have you correctly applied it to the GitHub Repository for your project?

  • Is the copyright header correctly applied to your files in GitHub?

  • Have you confirmed that any intellectual property is removed from the code, docs, and examples?

  • I and my legal reviewer, as well as my product and PM reviewer, have confirmed that there is no business interest in keeping this code confidential.

  • I and my legal reviewer confirm there is no business interest in enforcing copyright protection for this code.

  • I and my legal reviewer confirm that the code does not contain any third-party material (open source, proprietary, partner, customer, or otherwise).

  • I and my legal reviewer confirm that the code does not include any invention on which the company has, or might want to seek, a patent.

  • Have you cleaned up comments, issues, and pull requests to remove any potentially bad content?

  • My legal reviewer and I have checked the dependencies and validated that they do not impose any licensing difficulties.

  • I and my legal reviewer confirm there is NO encryption present in the code.

  • The repository that hosts the code is generally accessible to the public with no time limits or access restrictions.

  • This tool or library is not meant for use in any specific industry, platform, or process but rather for use by general customers.

Technical questions
  • Who verified your technical review?

  • Has your library documentation been reviewed by a documentation team member?

  • Has your source code documentation been reviewed by a developer team member?

  • Has end user testing been completed?

  • Has CI/CD testing been implemented?

  • Has a minimum test coverage of 80% been achieved?

  • Are usage and installation examples included and tested?

  • Is the package definition ready and PyPi packaging completed?

  • Does the GitHub repository supply contribution guidance and have CLA set up?

Business questions
  • Who on the Product Marketing Manager (PMM) or Developer Ecosystem (DevEco) team checked your project for readiness?

  • Did you tell ACE and your Business Unit lead that you are ready for release?

  • Is there something public that already has the same name as your project?

  • Did you get PMM signoff?

  • Did you ask the DevEco team to update links from the Developer Portal to your new OSS project?

  • Did you let the PMM team know that your library is nearing release?