Kendi Mimari Belgelerimiz Bunun Var Olmadığını Söylüyor ve "Alt Ağ" Kelimesi Öyle Durmuyor

Bu sayfanın anlattığı şey, hiçbir kurulumu olmayan bir şartnamedir ve etrafındaki kelime dağarcığı sorunun kendisidir.

Kelime dağarcığı sorunu, tek satırda

"Alt ağ" kurulmuş gibi duran bir isimdir. "Modül", "katman", "çalışma zamanı" ve "yürütme ortamı" da öyle. Bileşenleri adlandırırlar ve bir bileşen, ya var olan ya olmayan türden bir şeydir.

Mimari kelime dağarcığı o kesinliği ödünç alır. Altı kutulu bir şema altı şey gibi okunur ve bir okuyucunun hangi kutuların çalıştığını, hangilerinin yazılmış ve yayımlanmamış olduğunu, hangilerinin bir tasarım belgesinde bir paragraf olduğunu anlamasının yolu yoktur.

Bu genellikle bir aldatma değildir. Biçimin kendisi bu işi yapar ve bir alıcının her kutuyu ayrı ayrı sormasının sebebi budur.

Bu kutu ne

Bir şartname ve biraz erken araştırma. Kurulmuş bir alt ağ yok, açık bir uç nokta yok ve dışarıdan kimsenin çağırabileceği hiçbir şey yok.

Kendi mimari dokümantasyonumuz bu konuda açıktır: bu dahil alt ağlar bugün canlı ağda mevcut değildir. Kendimizi alıntılıyoruz çünkü iç belge kelime dağarcığından daha dürüsttür ve kelimeyle bir şemada karşılaşan bir okuyucu bunu tahmin edemezdi.

Var olmayan bir şey hakkında neden bir sayfa yazıyoruz

Çünkü alternatif, onun bir yetenekler listesinde görünmesi ve kimsenin ne tür bir şey olduğunu söylememesidir.

Bir şartname meşru bir üründür. Bir tasarımı inşa etmeden önce yayımlamak, inceleme almanın yoludur ve aksini iddia etmek kendi başına bir dürüstsüzlük olurdu. Meşru olmayan, bir şartnamenin çalışan bir hizmetle aynı görsel düzlemde durmasına izin verip okuyucunun ayırmasını ummaktır.

Yani: bu bir tasarımdır. İnşa edilmemiştir. Hiçbir şey ona bağlı değildir ve inşa ettiğiniz hiçbir şey de olmamalıdır.

Bir alıcının herhangi bir mimari şema hakkında sorması gereken

"Her kutu için: çalışıyor mu, yazılmış ama kurulmamış mı, yoksa tasarlanmış mı?"

Üç durum, ve çoğu satıcı materyali bunları tek bir duruma indirger. Listeyi isteyin ve üçüncü kategori farklı renklendirildiğinde şemaya ne olduğunu izleyin.

Bizde, bu bileşende, cevap üçüncüsüdür ve aynı şemadaki birkaç başkası birincisidir. Fark, şemanın kendisinden önemlidir.

Modüler mimarisi olan herhangi bir projeye sorulacaklar

"Hangi modüller kurulu, tek tek adlandırın?" Liste şemadan kısa olacaktır, her yerde, burası dahil.

"Bugün neyi çağırabilirim?" Uç noktalar kontrol edilebilir. Kutular değildir.

"İnşa edilmemiş parçalara ne bağlı?" Yayımlanmış bir yeteneğin hikâyesi yayımlanmamış bir bileşeni gerektiriyorsa, o yetenek göründüğünden az yayımlanmıştır.

"Kendi iç dokümantasyonunuz pazarlamanızla nerede çelişiyor?" Haksız bir soru ve cevabı bilgilendiricidir. Bizimki burada çelişiyordu, ki bu sayfanın var olma biçimi budur.

Bu karar için ne anlama geliyor

Sözleşmeler için bir yürütme ortamına ihtiyacınız varsa, bizde yok, uç nokta yok ve bunu değiştirmeye bağlı bir tarih yok.

Mimarimizin çalışan kısımlarını değerlendiriyorsanız, onlar çalışıyor, uç noktaları var ve şemalarımızı okumanın dürüst yolu şudur: biri size hangisinin hangisi olduğunu söyleyene kadar bazı kutular hizmettir ve bazıları niyettir.

Okumaya devam edin

Kendi Mimari Belgelerimiz Bunun Var Olmadığını Söylüyor ve "Alt Ağ" Kelimesi Öyle Durmuyor · Solidus