Bu sayfada, Google Dokümanlar Sezonu için kabul edilen bir teknik yazım projesinin ayrıntıları yer almaktadır.
Proje özeti
- Açık kaynak kuruluşu:
- GraphQL
- Teknik yazar:
- carolstran
- Projenin adı:
- SSS kaynağı oluşturma
- Proje süresi:
- Standart uzunluk (3 ay)
Proje açıklaması
Yeni bir teknolojiyi öğrenmek hiç kolay değildir ve birçok soruyu beraberinde getirir. GraphQL ile proje, bilgilerin büyük bir kısmının kullanıma sunulduğu kadar gelişti. Bu bilgiler çeşitli kaynaklara ve programlama topluluklarına dağılmış olduğu için tek yapmanız gereken bu bilgileri bulmaktır.
GraphQL'i öğrenenler için yararlı olabilecek bir iyileştirme, merkezi bir Sık Sorulan Sorular (SSS) bölümü olabilir. Bu öğe şu anda schemaql.org'da bulunmamaktadır ve sürekli olarak tekrarlanan ya da yanıtlanmamış sorulara yol açmaktadır.
Bu yeni SSS bölümü, graphql.org web sitesine entegre edilecek ve aşağıdakilerle ilgili bölümler içerecektir:
GraphQL geçmişi ve dahili özellikleri
- GraphQL Foundation nedir?
- GraphQL ne zaman ve neden oluşturuldu?
- Başlamak için en iyi kaynaklar hangileri?
GraphQL ile ilgili temel bilgiler
- GraphQL ile REST/SQL/vb. arasındaki fark nedir?
- GraphQL için en iyi kullanım alanları nelerdir?
- GraphQL yalnızca React geliştiricileri için mi?
Gelişmiş GraphQL kavramları
- GraphQL ile sunucu tarafında önbelleğe alma işlemini nasıl yapabilirsiniz?
- GraphQL çevrimdışı kullanımı destekler mi?
- GraphQL API'nizi nasıl test edebilirsiniz?
Spesifikasyon
- Spesifikasyona nasıl katkıda bulunabilirim?
- Spesifikasyon sürümlerini takip etmenin en iyi yolu nedir?
Ayrıca ileride başka bölümler de ekleyeceğiz. Yukarıdaki sorular olası örneklerdir. Ayrıca, GraphQL'yi öğrenen iş arkadaşlarım tarafından veya GraphQL ile ilgili bir konferans konuşmasından sonra bana sorulan soruların da hepsini bu makalede bulabilirsiniz.
SSS'deki sorular, internetin çeşitli alanlarından alınır ve daha sonra sıralanır ve öncelik verilir. Bu alanlardan bazıları şunlardır:
- StackOverflow
- GitHub sorunları (GraphQL kuruluşunda, How To GraphQL ve daha ilerisinde)
- Önde gelen GraphQL eğitmenleriyle yapılan sohbetler
- GraphQL ile ilgili ürün sayfaları
- Quora
Son SSS sayfası, kısa ve faydalı içeriğin yanı sıra kullanıcı deneyimi ve erişilebilirlik göz önünde bulundurularak oluşturulur.