Markdown ve GitHub ile not alma

Mar 07 2023
Markdown ve GitHub kullanarak not almak için nasıl basit bir havuz yaptım. Anlıyorum, not almayla ilgili binlerce YouTube videosundan ve blog gönderisinden bıktınız.

Markdown ve GitHub kullanarak not almak için nasıl basit bir havuz yaptım.

Fotoğraf: Karolina Grabowska: https://www.pexels.com/photo/crop-man-with-pen-and-opened-notebook-4195401/

Anlıyorum, not almayla ilgili binlerce YouTube videosundan ve blog gönderisinden bıktınız. Ben de! Bu yüzden lafı uzatmaya ve olabildiğince basit, BS içermeyen kendi not alma sistemimi kurmaya karar verdim.

Fikir mi ? Evet, harika görünüyor ama o dik öğrenme eğrisini tırmanacak vaktim yok.

Temel olarak not almak için herhangi bir mobil uygulama var mı? Olabilir, ancak çalışırken hızlı bir şekilde bilgi arayabilmek, içerik değiştirmeyi en aza indirgemek ve umarız bu sırada ellerimi klavyemin üzerinde tutabilmek istiyorum.

Düz metin dosyası mı? Belki biraz fazla aşırı, evet basit ve sıfır bakım gerektiriyor, ancak notlarımın okunabilir olmasını istiyorum ve diğer yandan yazdıklarımı biçimlendirmekle zaman kaybetmek istemiyorum… peki şimdi beni kim kurtarabilir?

Markdown'a girin . Yazması kolay, sözdizimine alışmak çok az zaman alıyor ve sonuç kabul edilebilirden de fazla!

Şimdi şu durumu hayal edin: Seçtiğiniz metin düzenleyicide büyük bir kod tabanına göz atıyorsunuz ve bir işlev veya yöntem kullanımıyla karşılaşıyorsunuz ve bunun uygulanmasını yeniden gözden geçirmek istiyorsunuz. Normalde bu durumda yaptığım şey, VS Code üzerinde proje çapında bir arama başlatmak ve anında sonuç almak. Öyleyse neden her iki dünyanın en iyilerini bir araya getirmiyoruz?

Markdown ve VS Code birlikte, herhangi bir not alma sistemindeki en büyük iki sorunuma çözüm sağlıyor: minimum biçimlendirme çabasıyla kolayca okunabilir notlar yazmak ve istediğim zaman bilgileri sorgulama yeteneği .

Peki, nasıl inşa edersiniz? GitHub'da boş bir depo oluşturmak, ardından Web için Visual Studio Code'u başlatmak kadar kolaydır .

Web için VS Kodu.

İçeri girdikten sonra, "Klasörü Aç" ı tıklayın ve VS Code, yerel klasörleri açmanın desteklenmediğini söyleyecek ve bunun yerine uzak bir klasör açmanıza izin verecektir. GitHub hesabınızla giriş yaparak istediğiniz depoyu açabileceksiniz.

Notlarımı şu şekilde yapılandırmayı seviyorum:

- <Project Name>
  - Useful Commands
  - Research
  - Tasks

Useful Commands , her proje klasörünün içinde, Docker kapsayıcılarını başlatma, testleri çalıştırma vb. görevler için yararlı komutlar içeren tek bir işaretleme dosyası barındırır.

Araştırma , farklı konular için araştırma notları tutar, buradaki asıl amaç, kavramları başka biri için açıklıyormuş gibi kendime açıklamaya çalışmaktır.

Görevler , üretkenliğimde en büyük etkiyi yaptığına inandığım görevler. Buraya atandığım her Jira bileti için bir Markdown dosyası yerleştiriyorum ve şu şablonu takip etmeye çalışıyorum:

# JIRA_ID - Ticket name
Short description of the task. 
If the task doesn't have an acceptance criteria it is a good exercise 
to read the description a few times and write it down yourself.

In here I leave a space for pasting useful material, like code snippets,
links, YouTube videos, anything that might help me answer whatever
questions arise.

## Steps To Succeed
Step by step definition, with clear action items to achieve a solution.
Include possible alternate paths, and every thought that helps you implement
your idea.


Bu seferlik bu kadar, eğer bu yazının sonuna kadar geldiyseniz çok teşekkür ederim ve iyi günler! :)