diff --git a/dev/README.md b/dev/README.md index 19e556e..ee43157 100644 --- a/dev/README.md +++ b/dev/README.md @@ -5,6 +5,7 @@ Bu dizinde Ahenk arka yüz geliştiricileri ve Ahenk eklenti geliştiricileri i ### Index +- **[Yeni Geliştiriciler İçin](newdev.md)** - [Tüm Kaynaklar ve Harici Bağlantılar](resources.md) - [Geliştirici Ortamının Kurulması ve Öneriler](environment.md) - [Changelog](changelog.md) diff --git a/dev/dev-notes/asandikci.md b/dev/dev-notes/asandikci.md index 55020b2..1b4aac5 100644 --- a/dev/dev-notes/asandikci.md +++ b/dev/dev-notes/asandikci.md @@ -17,7 +17,7 @@ Yazılım geliştirme konusunda uzman olmadığımdan, go dilini daha önce kull - Basit Syntax - Modul mantığı ve proje yapısı - Plugin mantığı - - Concurrency/goroutine mantığ˙í + - Concurrency/goroutine mantığı - Linux Daemon - Daemon mantığı (forking) - Iki farklı dilde daemon implementationu diff --git a/dev/newdev.md b/dev/newdev.md new file mode 100644 index 0000000..af4b45c --- /dev/null +++ b/dev/newdev.md @@ -0,0 +1,76 @@ +# Yeni Geliştiriciler için Açıklamalar +Bu projede devam edecek olan geliştiriciler, stajyerler veya katkı sağlamak isteyen harici *contributor*lar için başlangıç kılavuzu, açıklamalar ve öneriler. Bu dosyasyı, hâlihazırda olan dökümantasyonların sırasıla daha iyi anlaşılması için bir roadmap gibi düşünebilirsiniz. + +## Gereklilikler +### Geliştirme Ortamının kurulması +- Geliştirme ortamı için go dilini paket yöneticinizden veya resmi sitesinden kurunuz (>=1.19) +- [environment.md](environment.md) dosyasındaki adımları izleyiniz. VSCode/Codium + Eklentilerini kullanmanız kolaylık ve geliştirme sürecinin bütünlüğünü sağlayacağı için *önerilmektedir* +- Eğer .deb paketi buildleyecek iseniz veya harici testler gerçekleştirmek istiyorsanız [docker geliştirici ortamı kurmanız](environment.md#creating-docker-development-environment) *önerilmektedir* ~~*yeni başlayan stajyerler bunu daha sonra halledebilirler*~~ + +### Golang +- Ahenk-go Go dili ile yazılmıştır. Dolayısı ile go dilinin synatxini, modül ve proje yapısını, concurrent programlamayı ve plugin mantığını bilmeniz önerilmektedir. +- Kaynaklar için [resources.md](resources.md#go) dosyasındaki ilgili linkleri veya [asandikci/go-learning](https://git.aliberksandikci.com.tr/asandikci/go-learning) deposunu kullanabilirsiniz + +### Diğer +Go dili ve ortamın kurulması haricinde bunlar hakkında bilgi sahibi olmanız da işinize yarayabilir: +- Git versiyon kontrol kullanımı +- Shell kullanımı, Genel Linux bilgisi +- Linux Daemon - Windows Service çalışma mantıkları +- Sanal makine çalıştırma +- XMPP (bu dosya yazıldığı an itibarı için projenin ilerisi için) +- LDAP (bu dosya yazıldığı an itibarı için projenin ilerisi için) +- PAM modülleri (bu dosya yazıldığı an itibarı için projenin ilerisi için) +- ... + +## Projenin çalışma mantığının anlaşılması +- Projenin mantığının anlaşılması için sırasıyla ilk önce [howto.md](howto.md) dosyasına göz gezdirmeniz sonrasında [changelog.md](changwelog.md) dosyasını en alttan en üste doğru okumanız önerilmektedir. (daha kısa versiyonları için [admin](../admin/) dizinine göz gezdirebilirsiniz) +- Özetlemek gerekirse ahenk basitçe sistem başladığında daemon olarak çalışan, Lider'den gelen komutları uygulayan ve sonuçlarını geri Lider'e ileten bir client uygulamasıdır. Gerekli komutları yapmak için ilgili pluginleri kullanır. Son kullanıcı [Ahenkdesk](https://github.com/Pardus-LiderAhenk/ahenkdesk) uygulaması ile aynı zamanda Lider ile iletişime de geçebilir ve ilgili bilgileri öğrenebilir. +- İlgili dökümantasyonları okuduktan sonra projedeki [cmd/ahenk-go/main.go](https://git.aliberksandikci.com.tr/Liderahenk/ahenk-go/src/branch/main/cmd/ahenk-go/main.go) dizinine gidip kodu incelemeniz *önerilmektedir* + +## Geliştirme Sürecinin devamlılığı +- Geliştirme sürecinin devamlılığını sağlamak için [environment.md](./environment.md) dosyasındaki anchor'ları kullanmanız önerilmektedir. Kod editörünüz içinde NEXT, TODO, FIXME ... kelimelerini aratıp eksik/hatalı kod öbeklerini doldurabilrsirsiniz. Siz de kendi anchorlarınızı eklemekten çekinmeyin. +- ahenk-docs dökümanlarında veya ahenk-go projesinde herhangi bir dosyayı, fonksiyonu vb. yeniden isimlendirirken,oluştururken veya silerken hâlihazırdaki dökümantasyon/kod içersinde aratıp başka bir soruna yol açmayacağından emin olunuz. (örneğin bu dosyanın isminin newdew2.md olması durumunda README.md dosyasının da update edilmesi veya pluginlerden birindeki bir fonksiyonun isminin değiştirilmesi durumunda plugin-manager'de de fonksiyon isminin değiştilmesi vb.) +- Dökümantasyona özen gösteriniz, özellikle hem [admin](../admin/) hem de [dev](../dev) klasöründeki howto.md ve changelog.md dosyalarını olabildiğince sık güncellemeye çalışınız. Anlaşılırlığı arttırmak için harici veya dahili bağlantılar da kullanabilirsiniz. +- [Kaynakları](./resources.md) olabildiğince sık güncellemeye çalışınız. Gereksiz bağlantıları silip daha yeni veya daha iyi bağlantıları tutunuz. Olabildiğince kısa, öz ama bir o kadar da bilgilendirici kaynakları toplayınız *ki herhangi bir noktada eksiği olan geliştirici/stajyerler hızlıca bilgilere erişebilsin* +- Kod içinde fonksiyonlardan, methodlardan ve diğer uzun kod bloklarından önce; ne işe yaradığı, nasıl çalıştığı ve neden öyle olduğunu açıklayan anlaşılır yorumlar koyunuz. Aynı zamanda diğer gerek duyduğunuz yerlere kısa yorum satırları eklemekten çekinmeyiniz. Açıklayıcı ve anlaşılabilir yorumlar yazmak ve bir dökümana dönüştürmek için [go yorum rehberini](https://go.dev/doc/comment) takip ediniz. +- Kodun anlaşılabilirliğini sağlamak için [Go stil rehberini](https://google.github.io/styleguide/go/) takip ediniz. + +- Git commitlerini olabildiğince açıklayıcı bir şekilde yazınız, [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) şeklini veya geliştirici ekibin kullandığı şekli kullanabilirsiniz. Her şekilde en önemlisinin commitlerin birbirleri ile uyumlu olmasının olduğunu unutmayınız. + +## Geliştirme Süreci +- Kod içlerindeki anchor'lardan ilerleyiniz. (NEXT, TODO, FIXME, REVIEW, FILLME) +- Git adresindeki Issue'lerden ilerleyiniz. +- Mattermost (veya kullanılan diğer adres)teki roadmap'ten ilerleyiniz. +- [Python implementasyonundaki](https://github.com/Pardus-LiderAhenk/ahenk) özelliklerden/pluginlerden devam ediniz. + +### Genel Taslak +- [x] Linux Daemon +- [ ] Windows Service +- [x] Deb Packaging +- [x] Docker Dev Environment +- [x] Plugin Manager +- [x] plugins/resources +- [ ] Dynamic Plugin Manager (with unload, reload feature) +- [ ] Connection to Lider with XMPP +- [ ] Connect with Ahenkdesk +... +- [ ] plugins/usb +... +- [ ] plugins/LDAP +... +- [ ] plugins/... (Look more in [python implementation](https://github.com/Pardus-LiderAhenk/ahenk/tree/master/src/plugins)) +... +- [ ] a running Docker Ahenk-go container +- [ ] Testing with different operating systems, distributions +... + +

+ +--- + +
+ +#### Ekstra +- commitlerinizi GPG ile şifreleyebileceğinizi biliyor muydunuz? +- geliştirme sürecini yönetmeniz için (~~*eğer liderahenk ekibi proje üzerinde çalışmaya başladıysa ve sizin için bir mattermost hesabı açıldıysa*~~) bir mattermost hesabı talep edip roadmap üzerinden ilerleyebilirsiniz. Veya GitHub/Forgejo üzerindeki Issue/Proje sayfası üzerinden kendinize bir roadmap oluşturabilirsiniz. Veya en basitinden bir txt dosyası ile kendinize bir roadmap oluşturabilirsiniz. +- eğer projede hangi görevde çalıştığınız, notlarınızı ve düşüncelerinizi paylaşmak istersiniz [dev-notes](./dev-notes/) dizine isminizi (*veya isterseniz gizlilik nedeni ile nickinizi*) ekleyip yeni bir markdown dosyası oluşturabilirsiniz. \ No newline at end of file