Difference between revisions of "Contributing"

From AllStarLink Wiki
Jump to navigation Jump to search
 
(One intermediate revision by one other user not shown)
Line 9: Line 9:
 
Our next release is currently in beta, and all contributions are welcome.
 
Our next release is currently in beta, and all contributions are welcome.
  
* Submit any bug/issue reports here: https://github.com/AllStarLinkInc/ASL-Live-Build/issues
+
* Submit any bug/issue reports here: https://github.com/AllStarLink/ASL-Live-Build/issues
 
== Contributing ==
 
== Contributing ==
 
* Fork the repository
 
* Fork the repository
Line 16: Line 16:
 
* If your pull request is accepted, your change will be merged.
 
* If your pull request is accepted, your change will be merged.
 
* All copyrights should be assigned to AllStarLink, Inc. This ensures that any disputes over copyrighted code can be resolved through our non-profit.
 
* All copyrights should be assigned to AllStarLink, Inc. This ensures that any disputes over copyrighted code can be resolved through our non-profit.
  (C) 2018-2021 AllStarLink Inc.
+
  (C) 2018-2023 AllStarLink Inc.
  
= Contributing to the [https://github.com/AllStarLinkInc/Asterisk AllStar Client Github Repository] =
+
= Contributing to the [https://github.com/AllStarLink/ASL-Asterisk AllStar Client Github Repository] =
  
 
Like any open source project, AllStarLink's Github repo has a few basic rules regarding contributions.
 
Like any open source project, AllStarLink's Github repo has a few basic rules regarding contributions.
  
1. Make sure you only make a pull request on the relevant development branch.  (''Currently [https://github.com/AllStarLinkInc/Asterisk/tree/develop develop]'')
+
# Create an issue detailing the enhancement or bug in the [https://github.com/AllStarLink/ASL-Asterisk/issues ASL-Asterisk Gihub Repository] issue tracker.  If you will be submitting a pull request, assign the issue to yourself.  The repository maintainers and users will use this issue to comment on the proposed enhancement or bug.
 
+
# Make sure that you make a pull request on the relevant development branch.  (''Currently [https://github.com/AllStarLink/ASL-Asterisk/tree/develop develop]'')
2. Do annotate your changes so that they are easily understood when reviewed.
+
# Do annotate your changes so that they are easily understood when reviewed.
 
+
# Your code submission must follow the [https://wiki.asterisk.org/wiki/display/AST/Coding+Guidelines Asterisk Coding Guidelines.]  All submissions will go through code review by the repository maintainers.
3. Do ensure that if your submission contains work from or based on other projects, that you have clearly identified this work, provided a link to the source material, and ensured that the license is compatible with the GNU GPL v2.
+
# Do ensure that if your submission contains work from or based on other projects, that you have clearly identified this work, provided a link to the source material, and ensured that the license is compatible with the GNU GPL v2.
 
+
# Do ask questions on the [http://community.allstarlink.org community page] before submitting a pull request. Reviews are appreciated as well.
4. Do ask questions on the community page [http://community.allstarlink.org] before submitting a pull request. Reviews are appreciated as well.
+
# Do not claim credit or ownership for code that is not yours.
 
+
# All copyrights should be assigned to AllStarLink, Inc. This ensures that any disputes over copyrighted code can be resolved through our non-profit.
5. Do not claim credit or ownership for code that is not yours.
+
  (C) 2018-2023 AllStarLink Inc.
 
 
6. All copyrights should be assigned to AllStarLink, Inc. This ensures that any disputes over copyrighted code can be resolved through our non-profit.
 
  (C) 2018-2021 AllStarLink Inc.
 
  
 
[[Category:Development]]
 
[[Category:Development]]

Latest revision as of 14:35, 27 May 2023

Infrastructure / Web Portal

We're currently looking for volunteers to contribute to the ever growing ASL infrastructure. If you feel you can help out in any way, please contact volunteer@allstarlink.org.

Some technologies we use:

  • Asterisk
  • C/C++
  • mySQL
  • Redis
  • Front End HTML/JS
  • PHP7, VueJS, Laravel 7
  • Docker
  • Javascript / NodeJS
  • Google Cloud Compute
  • Linux
  • Perl (not for new use)
  • Python
  • Docker
  • Technical Writers / Documentation Writers

ASL Linux Distribution

Our next release is currently in beta, and all contributions are welcome.

Contributing

  • Fork the repository
  • Create a feature branch, such as "fix-problem-x-y-z"
  • Create a pull request for your feature branch against the 'develop' branch
  • If your pull request is accepted, your change will be merged.
  • All copyrights should be assigned to AllStarLink, Inc. This ensures that any disputes over copyrighted code can be resolved through our non-profit.
(C) 2018-2023 AllStarLink Inc.

Contributing to the AllStar Client Github Repository

Like any open source project, AllStarLink's Github repo has a few basic rules regarding contributions.

  1. Create an issue detailing the enhancement or bug in the ASL-Asterisk Gihub Repository issue tracker. If you will be submitting a pull request, assign the issue to yourself. The repository maintainers and users will use this issue to comment on the proposed enhancement or bug.
  2. Make sure that you make a pull request on the relevant development branch. (Currently develop)
  3. Do annotate your changes so that they are easily understood when reviewed.
  4. Your code submission must follow the Asterisk Coding Guidelines. All submissions will go through code review by the repository maintainers.
  5. Do ensure that if your submission contains work from or based on other projects, that you have clearly identified this work, provided a link to the source material, and ensured that the license is compatible with the GNU GPL v2.
  6. Do ask questions on the community page before submitting a pull request. Reviews are appreciated as well.
  7. Do not claim credit or ownership for code that is not yours.
  8. All copyrights should be assigned to AllStarLink, Inc. This ensures that any disputes over copyrighted code can be resolved through our non-profit.
(C) 2018-2023 AllStarLink Inc.