================================================================================================
                                    Fishing for the projects      
================================================================================================

The projects will be done in 3-4 person groups. Use today's time to find partners and 
interesting topic.

The project is software-related. It means that you need to find some bioinformatics related
project you want to contribute to (e.g. biopython). The project should be available in GitHub*. 
You can 'fork' and build on top of it, new functionalities/features.

The project can be also a new GitHub repository made from scratch. Balance the work. Do not think
that you can make a completely new ML package like sklearn during those few hours. Think rather
about modifying existing packages. Frequently, popular packages have a long list of requests that
need to be done (e.g. cleaning the code, implementing some additional algorithm, rewriting the
code to fit the package structure [functions to classes]).

Yet, if you have already some code you use frequently for your needs (e.g. you worked with NGS
data and you have some specific scripts for converting or/analyzing standard files) maybe this 
is a good time to start your own project on GitHub for which you will be responsible.

Note: Before start, check if something similar does not exist already. It is better and easier 
to contribute to some project than having another version of the same project and in the end,
nobody (except you) cares about it.


In the end, you need to describe the changes you have done (what has been changed, why it was
needed, etc.)

* If you do not have an account on GitHub or you did not work with Git use this also as an
opportunity to learn it.

https://guides.github.com/activities/hello-world/
https://product.hubspot.com/blog/git-and-github-tutorial-for-beginners
https://www.edureka.co/blog/how-to-use-github/
https://www.freecodecamp.org/news/the-beginners-guide-to-git-github/
https://www.dataschool.io/how-to-contribute-on-github/

The main GitHub URL is:
https://github.com/lukasz-kozlowski/ADP_2025

TODO:
1) go to the above GitHub URL and do Tasks 1 & 2
2) create your first repository (if you are already an experienced user of GitHub you can 
   omit this step - this will be seen at your profile)
   
====================================================================
Handy commands & tips:
====================================================================
git clone git@github.com:lukasz-kozlowski/ADP_2025.git          # clone the main repo

git config --global user.name "lukasz-kozlowski"                # obviously modify to you
git config --global user.email "lukasz.kozlowski.lpk@gmail.com" # obviously modify to you

git config --global core.editor "nano"                          # editor 'vi' to 'nano' change

# authentication
https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent

https://www.theserverside.com/blog/Coffee-Talk-Java-News-Stories-and-Opinions/github-clone-with-ssh-keys

https://github.com/settings/keys                       # add public key from your machine

git add .
git status
git commit -a
git push
git push https://github.com/lukasz-kozlowski/ADP_2025.git

======================================================================================
Tutorials:

https://www.w3schools.com/git/default.asp
https://www.freecodecamp.org/news/the-beginners-guide-to-git-github/
https://www.slideshare.net/LarsYde1/version-control-issue-tracking-and-communication
https://guides.github.com/activities/hello-world/
https://product.hubspot.com/blog/git-and-github-tutorial-for-beginners
https://www.edureka.co/blog/how-to-use-github/
https://www.freecodecamp.org/news/the-beginners-guide-to-git-github/