Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Build and Developer Experience Issues

Open
  • Is something wrong?
#38 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Stale
Tech stack
cpp, python
Domain
build-system, developer-experience, documentation, release

Research direction

Start with the repository README build instructions and the gltf/README.md compatibility section; compare them with the usd-core package and linked GitHub Releases. Done means defining a minimal glTF plugin build path and documenting artifacts, OpenUSD compatibility, and LTS information; the issue names no implementation files or tests.

Written by the indexing model from the issue text.

Description

Introduction

While attempting to contribute tests and automation to the glTF plugin included to this repository, participants of Khronos' 3D Formats Tooling TSG expressed facing challenges in configuring and building the sources offered here. This issue collects the feedback expressed by members of the group, in the hope of facilitating onboarding and promoting contributions to this project – for which members are grateful.

Context

The 3D Formats Tooling TSG operated by Khronos was hoping to compile a list of features supported for interoperability between glTF and OpenUSD, through an accurate gap analysis and accompanying test suites against the glTF Sample Assets. The information collected by performing this exercise would have contributed knowledge to the general community about the breadth and stability of the interoperability features, and opened the door to contributions for features that may have been identified as desirable, if missing.

Although described in the project's README files, the instructions for configuring a build environment and configuring a build for producing the glTF File Format plugin for OpenUSD appeared to be more intricate than expected for the majority of potential contributors not yet familiar with OpenUSD.

This initial high barrier to entry may inadvertently cause individuals who would have been keen on contributing their expertise to the OpenUSD File Formats in this repository to invest their time in other projects where they perceive being more impactful, preventing them from further developing and supporting the valuable resources Adobe shares here.

Current Behavior

In attempting to set up their environments for contributing to the projects, members have noted that although build instructions are present in the repository's README file, they can appear challenging to potential contributors not fully versed in OpenUSD. Feedback from some include:

  • As of this writing, build artifacts for the plugins are not available through PIP packages or GitHub Releases. This currently requires contributors to build from sources, with build instructions hinting at building the all File Format plugins present in this repository when only a subset may be desired.
    • e.g. Contributing only to the glTF File Format plugin may require fewer dependencies and options than otherwise required to produce artifacts for all plugins.
  • Alignment and compatibility with OpenUSD releases is currently offered through badges at the top of README files. Contributors may wish to have more prominent access to information related to Long-Term Support of release cadence for newer versions of OpenUSD.

Key Desired Abilities

In attempting to contribute to this project, Khronos members noted they were looking to perform validation tests for glTF assets referenced within OpenUSD Stages, and faced challenges in attempting to accomplish this. In particular, they noted they were seeking to perform the following actions on this repository:

  1. Download prebuilt artifacts, in order to install via PIP the OpenUSD File Format plugins compatible with the official usd-core package. Including:
    1. Build artifacts compatible with platforms officially supported by OpenUSD (i.e. Windows, Linux, MacOS).
    2. (Optionally) Build artifacts available alongside the repository's GitHub Releases.
  2. Access developer documentation, which:
    1. Indicates the compatibility between File Format plugins and the corresponding OpenUSD release(s).
    2. States the minimal required steps to build File Format plugins (in particular, the glTF File Format plugin).
    3. Speaks to the intended to the Long-Term Support (LTS) of offered File Format plugins vis-à-vis their corresponding OpenUSD versions.

Note: Some participants expressed facing challenges when attempting to set up their environments for contribution due to File Format plugins as they were not aware of the required corresponding OpenUSD versions. Today, this information is only present through badges at the top of README files, which indicate File Format plugins are built via automation for OpenUSD 24.05 while Pixar offers 24.08 by default (with 24.11 releasing in the near future).

References

Dominant language
C++
Stars
397
Forks
42
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from adobe/USD-Fileformat-plugins

All issues in adobe/USD-Fileformat-plugins

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.