Favorite Repositories - bounswe/2021SpringGroup12 GitHub Wiki

.NET Runtime

README:

  • Starts with the summary of what repo contains.
  • Answers the" what" question and Gives the official page, the common questions are answered.
  • Gives the crucial points as how to use, roadmap and releases via beneficial links.
  • In general, README is quiet organized and understandable where each statement is supported by certain links.

ISSUE:

  • "Discussion" label can contribute to team in terms of planning the times to have the meetings.

Reference: https://github.com/dotnet/runtime
Refika Kalyoncu

Scikit-Learn

README:

  • Just like in .NET, scikit-learn first gives a brief intro and answers the "what" question.
  • Skicit-learn has also included images to the repo which makes it look much more attractive.
  • Since it's a library rather than explanation of what it is, they mostly emphasized on user part and explained the how to install type ofquestions mostly.
  • Also the links for communication and documentation are given.
  • The repo is easy to follow by a user

WIKI:

  • The wiki is quite organized.
  • In main page there exist only the headers and the titles which makes it easy to find what you are looking for.

ISSUE:

  • The "Easy" label looks quite usable, if one has a short time and wants to start a job, these "Easy" labels can be handled.
  • The "Needs ..." can also be convenient since it directly points to the requirement of the label.

Reference: https://github.com/scikit-learn/scikit-learn
Refika Kalyoncu

Flutter

Flutter is an open-source UI software development kit (SDK) created by Google. With Flutter you can develop applications for Android, iOS, desktop and web from a single codebase. I used this SDK during my internship and I liked it because it was easy to learn and we can create an app for both Android and iPhone with same source code. We can say that Flutter is a child since it's deployed in 2017 and it's growing day by day thanks to Google.

  • Readme page is colorful and alluring. Page starts with what is Flutter and continues with documentation. Documentation consists of installing, documentation, development wiki and contribution to Flutter. Also they have made a mailing list which they announce about the updates and releases. Read me page continues with why someone should use Flutter and it's advantages with supported with images.
  • There are more than 8000 open issues, therefore we will see improvements an new features over time for sure.
  • Unlike the readme page, wiki page has no images except logo. I really liked their wiki page.
    • Issue prioritization page explains clearly what to do to open-source contributors when they want to create an issue.
    • Design documents page explains the communication plan.
    • Tree hygiene page explains which steps to be taken to contribute a new feature for an open source developer.
    • and so on.

This wiki page amazing overall and I will definitely look here when we design our wiki page.

Reference: https://github.com/flutter/flutter
Veyis Turgut

Spring Boot

I used this framework during my internship and instantly fell in love. It fastens development phase greatly, thus increases the productivity.

  • Readme page is so comprehensive that a beginner can install and create his/her first rest api easily.
  • Readme page also has many external links that contains useful guides and tutorials.
  • They encourage users to create issues when they face a bug or request a new feature.
  • Wiki page contains release notes, help and documentation of development process.

Reference: https://github.com/spring-projects/spring-boot
Veyis Turgut

Fbprophet

Prophet is a procedure for forecasting time series data, I used it while my internship and it helped me a lot with analyzing data and creating forecasts.

  • In its README file, there are adequately informative explanations regarding the cases where this package can fit, and its use is beneficial. There is a little information about the ones who developed this package too.
  • There are some helpful links about fbprophet including homepage, explanations in python and R, its source code, etc.
  • There are also installation guides for python and R for a bunch of operating systems.
  • The short history of the updates with corresponding version numbers is available in the README file. Every version has its own update explanations such as some bug fixes and newly added features.

Reference: https://github.com/facebook/prophet
Batuhan Tongarlak

ANTLR4

ANTLR (ANother Tool for Language Recognition) is a parser generator for reading, processing, executing, or translating structured text or binary files. It generates a parser that can build parse trees from a grammer. It's used to build languages and frameworks. I like it because it can be used in a compiler design.

  • It has a nice and clean README page. Explains what this tool is. It includes major contributors, links to documentation, FAQ and old versions. Also has useful information about getting starting to use ANTLR.
  • It has useful labels for issues in issues part. We can use some of them in our repository.

References: https://github.com/antlr/antlr4 https://en.wikipedia.org/wiki/ANTLR
İhsan Gökcül

React

React is a JavaScript library for creating user interfaces. Apart from the github page, it also has a great website in which every little detail is explained.

  • To me the best thing about the github page of React is that they kept it simple and short.
  • It only has some general subject headings that lists the related subfields by referral links always.
  • By using this short github README page, it gives the feeling of a book index. You see everything that can be done at a glance as a headline.
  • In addition to the book, you can easily access the titles you are interested in with the links.

Reference: https://github.com/facebook/react
Gökay Yıldız

CPython

Reference: https://github.com/python/cpython
Ömer Yılmaz

freeCodeCamp

freeCodeCamp is a code learning community and it has one of the most active repositories in GitHub. In its repository, you can find:

  • A detailed readme file which is mainly about certifications and how to report bugs and problems.
  • More than 15 thousand closed isssues and more than 25 thousand closed pull requests.
  • Security policy and security advisories
  • The license

Reference: https://github.com/freeCodeCamp/freeCodeCamp
Doğukan Türksoy

Extenject

Extenject is actually a forked and currently maintained version of Zenject which is a dependency injection framework for mainly Unity and C#. What I like about it is following:

  • The author was the primary author of the Zenject when he was working in Modest Tree and his access was removed after he left the company and he decided to keep maintaining it under the name Extenject. There is a lawsuit going on between him and the Modest Tree about the copyright of the project and he has published the filing and his defence in the repo as well.
  • The project itself is really well maintained as an open-source project so far. Issues have been tracked, new features added upon request and so on.
  • The documentation of the project is really good and can be used as a tutorial as well in my opinion.
  • It is more than just a dependency injection tool, they implemented some other handy tools for game development and added them to the framework as well.
  • Even though it doesn't have a wiki page, README contains a lot of information from the documentation to the how-to's.

Reference: https://github.com/svermeulen/Extenject
Berk Yamanoğlu

Visual Studio Code - Open Source

Visual Studio Code is a text editor made by Microsoft. It is currently one of the most popular source-code editors in the world. Its open-source code-base is developed by Microsoft and community together in this repo. Its README file and wiki are very well maintained and useful.

  • In its README you can find all the necessary information about how to contribute. It shows how to submit bug reports and fixes and other changes step by step. You can also find about bundled extension with the repo.
  • Its wiki is very detailed and well maintained. Microsoft shares the current Roadmap in regular intervals. You can also find the iteration plans as issues in the wiki.
  • Wiki also includes how the team utilizes iteration plans and how they are doing the planning. It is very helpful for a development team.
  • Wiki includes extensive resources for contribution and maintaining. All the necessary tools and information is available in the wiki. Anyone who wants to contribute can easily navigate through the wiki to submit bug reports, open issues, suggest something. Coding conventions and guidelines are also present there.
  • And lastly although it is not in the wiki VSCode has a great documentation repository which you can reach from the wiki side bar.

Burakcan Kazım Yeşil

Reference:https://github.com/microsoft/vscode

image sources(ordered):