(Original creator: thomas.shore)

We hope you have had a chance to browse around the Uniface samples on GitHub. This blog post will give you some background information and some useful tips for getting started.

Objectives of Using GitHub:

1. Provide an open public globally accessible area for Uniface code samples and examples
2. Theme focused
3. Encourage participation in Uniface projects
4. Ease configuration and setup of Uniface and Uniface examples

Globally Accessible

We are using GitHub.com to host our publically available repositories. In using GitHub.com as the code hosting platform you have the opportunity to work with project authors and on your own projects from anywhere. The GitHub platform is widely adopted, very well understood including many samples and guides (https://guides.github.com/activities/hello-world/) and has a variety of tooling on various platforms to interface with the repositories.

How to get to the Repositories

You can obtain access to the projects by navigating to the GitHub Uniface page https://github.com/uniface  and select a Repository. In this example I chose the Project-Startup repository. Once selected the following page will appear:

Click on: 





If you choose ‘Open in Desktop’ it will attempt to use ‘GitHub Desktop’ available here :

https://desktop.github.com/. Alternatively, you can just select ‘Download ZIP’ to download an archive of the project, extract and use as a sample.

Theme Focused

We have created a series of Repositories that include:

Encourage Participation

In utilizing GitHub you have the opportunity to FORK( https://help.github.com/articles/fork-a-repo/) the project or projects and add their functionality or techniques to your own project. Additionally, you can request that your additions/changes be incorporated into the master. There is no guarantee that your changes will be accepted, just like every other open-source initiative.

Simple setup and execution

Those Uniface projects that require some basic setup utilize the Project Setup Tool to configure the application for your environment, importing sources, creating shortcuts and compiling the application.

Conclusion

While no attempt is made to provide detailed instructions for using Git and GitHub there are numerous sites that provide instructions and tooling on how to use Git and GitHub. Please take advantage of those resources. As this is the beginning of this initiative please feel free to comment and make suggestions.