Skip to content

Documentation Enhancement: Readability, Grammar, and Formatting Fixes #1095

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: develop
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 22 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
## উদ্দেশ্য (motive)
## উদ্দেশ্য

ডেভেলপারদের জন্যে চিটশিট খুবই কাজের জিনিস। কারণ আমাদের পক্ষে অনেক কমান্ড বা কোনো লাইব্রেরীর সব ফাংশন একসাথে মনে রাখা সম্ভব হয় না। সেক্ষেত্রে আমরা যদি একটা তালিকা তৈরি করি যে অমুক কমান্ড বা ফাংশন অমুক কাজ করে তাহলে খুব সহজেই পরবর্তিতে কেউ কাজ করতে গেলে শুধুমাত্র সেই তালিকা দেখলেই প্রয়োজনীয় সবকিছু খুঁজে পাবেন। আমরা আমাদের পুরো জ্ঞানকে বিভিন্ন বিভাগে ভাগ করে শুধুমাত্র আসল ফাংশানালিটিগুলো খুব ছোট্ট করে বর্ণনা দিয়ে তালিকা তৈরি করতে পারি। যেগুলোতে পরবর্তিতে কোনো ডেভেলপার শুধু একটু চোখ বুলিয়ে নিলেই তার কাঙ্ক্ষিত জিনিসটা খুঁজে পাবেন। এরকম চিটশিট [এখানেও](https://devhints.io/) পাবেন। কিন্তু আমাদের লক্ষ্য হচ্ছে সম্পূর্ণ বাংলায় চিটশিট তৈরি করা।

Expand All @@ -7,52 +7,47 @@
Cheatsheets are very handy for developers. Because it is not possible for us to remember many commands or all functions of a library at once. In that case, if we make a list that such a command or function does such a thing, then very easily when someone wants to work later, they can find everything they need just by looking at that list. We can divide our entire knowledge into different categories and list only the actual functionality very briefly. In which later a developer will find what he wants with just a quick glance. Similar cheatsheets are available [here](https://devhints.io/). But our aim is to make cheat sheet in full Bengali. in future if you need we try to make the cheatsheet in english also.


## কিভাবে কাজ করে (How do it Works?)
## কিভাবে কাজ করে?

এই প্রজেক্টটি পুরোপুরি গিটহাব ভিত্তিক। এখানেই [**data**](https://github.com/devsonket/devsonket.github.io/tree/develop/data) নামক ডিরেক্টরির ভিতরে আমাদের সবগুলো চিটশীট **json** ফাইল আকারে সাজানো আছে। আমাদের মেইন অ্যাপ্লিকেশন এখান থেকেই ডাটাগুলো নিয়ে প্রদর্শন করাবে। আমাদের বর্তমানে দুই ফরম্যাটের চিটশীট সাপোর্ট করছে।

## How do it Works?

This project is completely GitHub based. This is where all our cheatsheets are organized as **json** files inside a directory called [**data**](https://github.com/devsonket/devsonket.github.io/tree/develop/data). Our main application will display the data from here. We currently support two formats of cheatsheets.

- কোড এবং বর্ণনা সহ ফরম্যাট([এখানে ডেমো দেখুন](https://github.com/devsonket/devsonket.github.io/blob/develop/data/demo/codendesc.json))

- Format with code and description([See demo here](https://github.com/devsonket/devsonket.github.io/blob/develop/data/demo/codendesc.json))

- শুধুমাত্র কোড([এখানে ডেমো দেখুন](https://github.com/devsonket/devsonket.github.io/blob/develop/data/demo/onlycode.json))
- মিক্স ([এখানে ডেমো দেখুন](https://github.com/devsonket/devsonket.github.io/blob/develop/data/demo/mix.json))

- Code Only([See demo here](https://github.com/devsonket/devsonket.github.io/blob/develop/data/demo/onlycode.json))
- mix ([see demo here](https://github.com/devsonket/devsonket.github.io/blob/develop/data/demo/mix.json))


_ভবিষ্যতে নতুন কোনো ফরম্যাটের প্রয়োজন হলে অবশ্যই যোগ করা হবে। আপনি চাইলে [এখান থেকে](https://github.com/devsonket/devsonket.github.io/issues/new?title=%E0%A6%95%E0%A6%BF%E0%A6%B8%E0%A7%87%E0%A6%B0%20%E0%A6%9C%E0%A6%A8%E0%A7%8D%E0%A6%AF%E0%A7%87%20%E0%A6%AB%E0%A6%B0%E0%A6%AE%E0%A7%8D%E0%A6%AF%E0%A6%BE%E0%A6%9F&body=%E0%A6%AC%E0%A6%BF%E0%A6%B8%E0%A7%8D%E0%A6%A4%E0%A6%BE%E0%A6%B0%E0%A6%BF%E0%A6%A4%20%E0%A6%AC%E0%A6%B2%E0%A7%81%E0%A6%A8&labels=%E0%A6%A8%E0%A6%A4%E0%A7%81%E0%A6%A8%20%E0%A6%AB%E0%A6%B0%E0%A6%AE%E0%A7%8D%E0%A6%AF%E0%A6%BE%E0%A6%9F) একটা ইস্যু তৈরী করতে পারবেন নতুন ফরম্যাট তৈরী করার জন্যে_

Any new formats will be added in future if needed. If you want [from](https://github.com/devsonket/devsonket.github.io/issues/new?title=%E0%A6%95%E0%A6%BF%E0%A6%B8%E0%A7%87%E0%A6%B0%20%E0%A6%9C%E0%A6%A8%E0%A7%8D%E0%A6%AF%E0%A7%87%20%E0%A6%AB%E0%A6%B0%E0%A6%AE%E0%A7%8D%E0%A6%AF%E0%A6%BE%E0%A6%9F&body=%E0%A6%AC%E0%A6%BF%E0%A6%B8%E0%A7%8D%E0%A6%A4%E0%A6%BE%E0%A6%B0%E0%A6%BF%E0%A6%A4%20%E0%A6%AC%E0%A6%B2%E0%A7%81%E0%A6%A8&labels=%E0%A6%A8%E0%A6%A4%E0%A7%81%E0%A6%A8%20%E0%A6%AB%E0%A6%B0%E0%A6%AE%E0%A7%8D%E0%A6%AF%E0%A6%BE%E0%A6%9F) can create an issue to create a new format_
## How does it work?

## কিভাবে কনট্রিবিউট করবেন **(How to Contribute)**
This project is completely GitHub based. This is where all our cheatsheets are organized as **json** files inside a directory called [**data**](https://github.com/devsonket/devsonket.github.io/tree/develop/data). Our main application will display the data from here. We currently support two formats of cheatsheets.

এখানে যেহেতু আমরা **json** ফাইল নিয়ে কাজ করছি তাই অনেকেই হয়তো **json** এর সাথে পরিচিত নাও থাকতে পারেন। সে উদ্দেশ্যে আমরা একটা [**draft**](https://github.com/devsonket/devsonket.github.io/tree/develop/data/draft) ডিরেক্টরিও রেখেছি **data** ডিরেক্টরির ভিতরে। আপনি যদি **json** ফাইল দিয়ে কনট্রিবিউট করতে নাও পারেন তাহলে আপনার যেকোনো ফরম্যাটে তৈরী করা চিটশিট পরিষ্কার টাইটেলসহ ড্রাফট ফোল্ডারে পুশ করে দিতে পারবেন। আবার একই সাথে আপনি চাইলে ড্রাফট ফোল্ডার থেকে কোনো ড্রাফট নিয়ে সেটাও **json** আকারে কনভার্ট করে আসল **data** ডিরেক্টরির ভিতরে পুশ করে দিতে পারেন। তো এভাবেই আপনি চাইলে **৪ রকমভাবে** এই প্রজেক্টে কনট্রিবিউট করতে পারবেনঃ
- Format with code and description([See demo here](https://github.com/devsonket/devsonket.github.io/blob/develop/data/demo/codendesc.json))
- Code Only([See demo here](https://github.com/devsonket/devsonket.github.io/blob/develop/data/demo/onlycode.json))
- mix ([see demo here](https://github.com/devsonket/devsonket.github.io/blob/develop/data/demo/mix.json))

**(How to Contribute)**
_Any new formats will be added in future if needed. If you want [from](https://github.com/devsonket/devsonket.github.io/issues/new?title=%E0%A6%95%E0%A6%BF%E0%A6%B8%E0%A7%87%E0%A6%B0%20%E0%A6%9C%E0%A6%A8%E0%A7%8D%E0%A6%AF%E0%A7%87%20%E0%A6%AB%E0%A6%B0%E0%A6%AE%E0%A7%8D%E0%A6%AF%E0%A6%BE%E0%A6%9F&body=%E0%A6%AC%E0%A6%BF%E0%A6%B8%E0%A7%8D%E0%A6%A4%E0%A6%BE%E0%A6%B0%E0%A6%BF%E0%A6%A4%20%E0%A6%AC%E0%A6%B2%E0%A7%81%E0%A6%A8&labels=%E0%A6%A8%E0%A6%A4%E0%A7%81%E0%A6%A8%20%E0%A6%AB%E0%A6%B0%E0%A6%AE%E0%A7%8D%E0%A6%AF%E0%A6%BE%E0%A6%9F) can create an issue to create a new format_

Since we are dealing with **json** files here, many may not be familiar with **json**. For that purpose we also put a [**draft**](https://github.com/devsonket/devsonket.github.io/tree/develop/data/draft) directory inside the **data** directory. If you can't contribute with a **json** file, you can push your cheatsheet in any format to the draft folder with a clean title. At the same time, if you want, you can take a draft from the draft folder and convert it to **json** format and push it inside the original **data** directory. So this is how you can contribute to this project in **4 ways** if you want:
## কিভাবে কনট্রিবিউট করবেন?

এখানে যেহেতু আমরা **json** ফাইল নিয়ে কাজ করছি তাই অনেকেই হয়তো **json** এর সাথে পরিচিত নাও থাকতে পারেন। সে উদ্দেশ্যে আমরা একটা [**draft**](https://github.com/devsonket/devsonket.github.io/tree/develop/data/draft) ডিরেক্টরিও রেখেছি **data** ডিরেক্টরির ভিতরে। আপনি যদি **json** ফাইল দিয়ে কনট্রিবিউট করতে নাও পারেন তাহলে আপনার যেকোনো ফরম্যাটে তৈরী করা চিটশিট পরিষ্কার টাইটেলসহ ড্রাফট ফোল্ডারে পুশ করে দিতে পারবেন। আবার একই সাথে আপনি চাইলে ড্রাফট ফোল্ডার থেকে কোনো ড্রাফট নিয়ে সেটাও **json** আকারে কনভার্ট করে আসল **data** ডিরেক্টরির ভিতরে পুশ করে দিতে পারেন। তো এভাবেই আপনি চাইলে **৪ রকমভাবে** এই প্রজেক্টে কনট্রিবিউট করতে পারবেনঃ

- বাংলায় যেকোনো টপিকের উপর চিটশিট **json** ফরম্যাটে আমাদের ফরম্যাট যেকোনোভাবে মেইন্টেইন করে পুশ করতে পারবেন
- বাংলায় যেকোনো টপিকের উপর চিটশিটের ড্রাফট যেকোনো ফরম্যাটেই পুশ করতে পারবেন
- অন্যের ড্রাফটগুলোকে আমাদের কাঙ্ক্ষিত **json** ফরম্যাটে কনভার্ট করে পুশ করতে পারবেন

এখানে প্রধান কয়েকজন কনট্রিবিউটর থাকবে যারা একটা চিটশিটকে আসল ওয়েবসাইটে দেখানোর কাজটা করবে। সেক্ষেত্রে যারা আমাদের কনট্রিবিউটরদের তালিকায় বেশী কনট্রিবিউট করবে অথবা যেকেউ যদি যথেষ্ট দায়িত্ববান মনে হয় তাহলে তাকে পুরো সংগঠনের অ্যাডমিনদের তালিকায় যুক্ত করা হবে।

## How to Contribute?

Since we are dealing with **json** files here, many may not be familiar with **json**. For that purpose we also put a [**draft**](https://github.com/devsonket/devsonket.github.io/tree/develop/data/draft) directory inside the **data** directory. If you can't contribute with a **json** file, you can push your cheatsheet in any format to the draft folder with a clean title. At the same time, if you want, you can take a draft from the draft folder and convert it to **json** format and push it inside the original **data** directory. So this is how you can contribute to this project in **4 ways** if you want:

- You can push cheatsheets on any topic in Bengali **json** format by maintaining our format in any way.
- You can push cheat sheet draft on any topic in Bengali in any format.
- Can convert other's drafts to our desired **json** format and push.

এখানে প্রধান কয়েকজন কনট্রিবিউটর থাকবে যারা একটা চিটশিটকে আসল ওয়েবসাইটে দেখানোর কাজটা করবে। সেক্ষেত্রে যারা আমাদের কনট্রিবিউটরদের তালিকায় বেশী কনট্রিবিউট করবে অথবা যেকেউ যদি যথেষ্ট দায়িত্ববান মনে হয় তাহলে তাকে পুরো সংগঠনের অ্যাডমিনদের তালিকায় যুক্ত করা হবে।
**English**

There will be a few main contributors who will do the work of showing a cheatsheet on the original website. In that case those who will contribute more in our list of contributors or if anyone seems responsible enough then he will be added to the list of admins of the whole organization.

**Contributing Guidelines📝**
## Contributing Guidelines📝

You are welcome to contribute to this project.
To start contributing, follow the below guidelines:
Expand Down Expand Up @@ -82,32 +77,32 @@ git push -u origin <your_branch_name>
15. Woohoo!🥳 You have made a PR to the **devsonket**. Wait for your submission to be accepted and your PR to be merged.
You made it! 🎊

## আইডিয়া খুঁজছেন?(Want an idea?)
## আইডিয়া খুঁজছেন?

আপনি যদি কোন টপিকের উপর চিটশিট করবেন সেটা বুঝতে না পারেন, তাহলে আমাদের [প্রোজেক্ট বোর্ড](https://github.com/devsonket/devsonket.github.io/projects/1?fullscreen=true) থেকে আইডিয়া নিতে পারবেন। [এখানে](https://github.com/devsonket/devsonket.github.io/projects/1?fullscreen=true) মূলত আমরা গুরুত্বপূর্ণ যে সকল চিটশিটগুলো সবার কাজে আসবে সেগুলোর তালিকা আপডেটেড রাখছি।

## Want an idea?

If you don't know what topic to cheatsheet on, you can get ideas from our [project board](https://github.com/devsonket/devsonket.github.io/projects/1?fullscreen=true). [Here](https://github.com/devsonket/devsonket.github.io/projects/1?fullscreen=true) Basically we keep updated list of important cheatsheets that will be useful for everyone.

## কেন কনট্রিবিউট করবেন?(Why you should contribute?)
## কেন কনট্রিবিউট করবেন?

হ্যাঁ, আমাদের এখানে লক্ষ্যই হচ্ছে বাংলাতে একটা বড় চিটশিটের ভান্ডার গড়ে তোলা। [এটা](https://github.com/devsonket) সম্পূর্ণ স্বাধীন এবং ওপেন সোর্স গিটহাব সংগঠন। এটি কারো ব্যক্তিমালিকানাধীন নয়। আমি আপনি সবাই মিলেই আমাদের লক্ষ্যে পৌছাবো।

## Why you should contribute?
## Why should you contribute?

Yes, our aim here is to build a big cheat sheet repository in Bengal. [It](https://github.com/devsonket) is a completely independent and open source GitHub organization. It is not privately owned. I will reach our goal together with all of you.


## কমিউনিটির আলোচনা (Discussions on Community)
## কমিউনিটির আলোচনা

আমাদের একটি ফেসবুক গ্রুপ রয়েছে। [এই লিঙ্কে](https://www.facebook.com/groups/675646289594096) ক্লিক করে সেখানে যুক্ত হতে পারবেন। আপনার কোনো ব্যাপারে সহায়তা প্রয়োজন হলে, কোনো রকম সাজেশন থাকলে অথবা যেকোনো ব্যাপারে খোলামেলাভাবে সেখানে আমাদের সবার সাথে আলোচনা করতে পারবেন।

## Discussions on Community

We have a Facebook group. You can join there by clicking [this link](https://www.facebook.com/groups/675646289594096). If you need any help, have any suggestion or discuss anything openly with all of us there.

## স্পন্সর(বিশেষভাবে ধন্যবাদ)**(Contributors)**
## স্পন্সর (বিশেষভাবে ধন্যবাদ) **(Contributors)**

- [Nazir Ahmed Sabbir](https://github.com/NaSabbir)
- [Blace](https://blace.com.bd/)
Expand Down