Contributing

Thank you for your interest in contributing to the NEXUS Framework! ♥️ We appreciate all forms of contributions, big and small — every little bit helps move the needle forward.

Bug reports, bug fixes, documentation additions, features, code, coffee, etc., benefit everyone.

While items on the Roadmap correspond to our own needs and ambitions, that doesn’t mean that contributions should be limited to just those things. If you want to drop in a feature that you think would benefit others, make a Pull Request! (against dev).

AI Policy

Included in the TestProject is a CLAUDE.md definition to assist Claude Code with understanding the NEXUS Framework as well as a series of skills (build, coding-style, running-tests, writing-tests).

In general the utilization of AI in engineering is an evolving process, and currently, for this framework it has been extremely helpful in providing research, bug finding assistance, and initial test generation.

Any AI-assisted contribution whether code, tests, or documentation must be reviewed, understood, and tested by a developer before it is committed. Contributors are fully responsible for everything they submit, regardless of how it was produced.

Automation

Every commit to the main branch (and PRs before being merged) undergoes an initial smoke test, followed by more intensive tests (including daily performance and functional tests, as well as packaging). This allows us to have some level of confidence in the framework and its capabilities.

There is also a manual test dispatcher (for approved contributors), which allows us to run tests ad hoc as needed. We also have some built GitHub actions which parse both the results JSON and the Unreal Editor log to bubble up details for ease of access.

While thorough testing is a core pillar of the framework, it is also important that we listen to real-world feedback from users of the framework to provide further validation of NEXUS. That’s a call out to everyone using the plugin to bubble up things when they happen!

Assisting With Documentaion

The documentation is meant to be a living document that allows for easy additions and corrections. The documentation is statically generated from a GitHub repository that can be easily edited. Each page of the documentation has a corresponding Edit this page link at the bottom.

Let's not kid ourselves... We are all a little lacking in documenting our work area, so this is our best bet at creating a spot to collate formalized documentation. Code documentation should still be present to mark up methods and other elements.

For more information about how to work with the documentation, please see its repository.

Source Assets

All of the source assets used by the NEXUS Framework are included in the repository. We elected to use Affinity Designer, Affinity Photo, and Blender as our tools of choice. This should allow for easier access for other developers who are tired of Adobe.