gltf icon indicating copy to clipboard operation
gltf copied to clipboard

RFC: Document supported environments

Open alteous opened this issue 6 years ago • 4 comments

I don't have the time/patience/knowledge/resources to support every environment under the sun. I'd like to make it clear in the documentation which environments are officially supported, which environments are not officially support but will probably work, and which environments are not supported.

The current list is rather short:

Officially supported

  • Linux
  • OSX
  • Windows

Not supported but probably works

  • Android

Not supported

  • WebAssembly, since the import function doesn't make sense for this use case.

Closes #203 and #211.

alteous avatar Jul 21 '19 10:07 alteous

Requirements for being listed as a 'supported' envrionment:

  1. We have first-class support for every feature in the crate.
  2. We have automated testing infrastructure in place to catch regressions.

alteous avatar Jul 24 '19 16:07 alteous

I've been using the crate on Windows without issue for some time. Is there anything that's holding back "official" support? I guess I didn't think there'd be any platform specific issues with this crate (other than maybe for WebAssembly).

I think travis now has support for Windows, although I haven't tried it.

Azure pipelines definitely supports Windows/Linux/OSX. I have some pipeline config that I could transform to work with gltf-rs. I'm happy to help and contribute it if you're interested in going that route.

aloucks avatar Jul 26 '19 00:07 aloucks

Is there anything that's holding back "official" support?

The second requirement is missing: continuous integration. I've created an AppVeyor account but still need to setup the script.

I took a quick look into Azure pipelines but got a bad impression. It's not crystal clear whether it's free for open-source projects. When I attempted to sign up with my GitHub account it wanted full access to my profile.

alteous avatar Jul 27 '19 21:07 alteous

I took a look into Travis too. As you mentioned, it now has some limited support for Windows server. I'm not sure whether the server edition 'counts' as proof of Windows compatibility. Having used Window server edition briefly I don't think there is much difference though.

alteous avatar Jul 27 '19 21:07 alteous