Contributing

[Mikko Vanhatalo]

Hi,

for a long time I've been lurking on ATS' progress and finally I've
plunged in. I've got a couple of questions:

I want to contribute. I'm in the process of making a small game using
ATS, and I'm using the SDL2 interface in ATS-Postiats-contrib. My plan
is to add more of the missing functions in the interface. What would be
the preferred way to contribute these changes back to the project?

So far I've forked the repository in GitHub and pushed my additions to it.
Should I send a pull request?

ATS seems like an awesome language!

[gmhwxi]

First, thanks for contributing!

Right now, this is how I organize contributed packages.

Essentially, all I do is creating a name space for you:

contrib/libats-XYZ

where XYZ is some identifier chosen by you.

For instance, I myself have the following name space:

contrib/libats-hwxi.

You can put SDL2 in

contrib/libats-XYZ/SDL2

Feel free to re-use the current code in contrib/SDL2

When you have a version that you want to 'release', you can issue a pull
request to inform me to pull it in.

People can always use the 'atspkgreloc' tool to try the 'nightly' version of
your package if it is available on-line. For instance, here is an example showing
how to use a package (PCRE) available on-line:

https://github.com/githwxi/ATS-Postiats/blob/master/utils/atspkgreloc/TEST/test03.dats

Cheers,

--Hongwei

[gmhwxi]

I made a minor change in terms of the structure of directories
for storing contributed packages.

Now there is a directory named 'libats-' in contrib. I will assign
name space under this directory. For instance, contrib/libats-hwxi
is now changed to

contrib/libats-/hwxi

For the name of a directory inside contrib/libats-, please choose
four letters or more (as I plan to reserve short names for something else).

That's it. Thanks for contributing!