DataFlex Open Source Code on GitHub: Difference between revisions
m
Added link to DataFlex topic page and a section about using DataFlexCode
Hsymington (talk | contribs) m (Corrected voluneering to volunteering.) |
Hsymington (talk | contribs) m (Added link to DataFlex topic page and a section about using DataFlexCode) |
||
| Line 6: | Line 6: | ||
Currently, it’s not possible to assign a language of DataFlex to the Languages, but we are working on that. | Currently, it’s not possible to assign a language of DataFlex to the Languages, but we are working on that. | ||
==Using DataFlexCode== | |||
The repositories in the DataFlexCode organisation are ‘Public’, i.e., anyone with a GitHub login is free to clone and use them. If you’re not familiar with GitHub, e.g., setting up, creating and forking repos etc., the [https://docs.github.com/en/github/getting-started-with-github/quickstart GitHub Quickstart guide] is a good place to start. | |||
DataFlexCode aims to make DataFlex code from the community available from a central place. These are your options for working with DataFlexCode on GitHub: | |||
===Going solo=== | |||
If you want to use an existing repo as the basis of your project, without any other complexity. Simply fork the repository you want to use and make your changes. If you find later down the line, that you want to merge what you’ve done back into the Main repository, you can do a ‘Pull Request’. | |||
===Contribute to an existing project=== | |||
If you know from the outset that you want to contribute to an existing repo on DataFlexCode, either: | |||
* Request permission to access the repo. | |||
* Fork the repo, make your changes and then add a ‘pull request’. The owner of the repo can then check the changes and merge in if appropriate. | |||
===Add your code to DataFlexCode=== | |||
Depending on whether you want to place your code within DataFlexCode, or just make it visible on DataFlexCode, you can either: | |||
* Contact an administrator and ask them to create a repo (with developer rights for you) to which you can upload your code. | |||
* Retain your code within your own account and ask an administrator to fork the repo so it’s visible on DataFlexCode. | |||
==DataFlex 'Topic' on Github== | ==DataFlex 'Topic' on Github== | ||
If you do add your own DataFlex code repositories to GitHub (in or outside of DataFlexCode) please take the time to add ‘dataflex’ as a 'topic' to your repository settings (using the cog to the right of About), so they are more visible to other DataFlexers. | If you do add your own DataFlex code repositories to GitHub (in or outside of DataFlexCode) please take the time to add ‘dataflex’ as a 'topic' to your repository settings (using the cog to the right of About), so they are more visible to other DataFlexers on the [https://github.com/topics/dataflex DataFlex Topic page]. | ||