Başlangıç

Mozilla Developer Network'ün her seviye teknik bilgiye hitap eden görevleri vardır. Programcı olmak ya da teknoloji hakkında çok şey bilmek zorunda değilsiniz. Basitten (redaksiyon ve yazım düzeltme) karmaşığa (API dokümanı yazmak), yapılması gereken pek çok farklı iş vardır.

MDN'in kelime işlemci kullanmış herkese tanıdık gelecek basit, web-tabanlı bir arayüzü vardır. Lütfen bize yardım edin! MDN'in başarısı Mozillian'lardan oluşan bir topluluğun işbirlikçi gelişim ruhuna dayanır.

  • İçerik tarzdan, gramerden ve imla kurallarından daha önemlidir. Eğer İngilizce'niz mükemmel değilse, endişelenmeyin! Eğer tarz rehberini ezberlemediyseniz, endişelenmeyin! İmla hatası yaparsanız, endişelenmeyin! Hataların düzeltilmesi kolaydır, ve değişiklikler kolayca ve hızla geri alınabilir.
  • Yardım isteyin ve MDN topluluğundaki yeni arkadaşlarınızla yazışın.  Topluluk (hem maaşlı, hem de gönüllü) dost canlısıdır. Yeni katılımcıları severiz! Eğer email ya da IRC ortamındaki sorunuza hızlı cevap alamazsanız, çok farklı projeler üzerinde ve çok farklı zaman dilimlerinde çalışan insanlar olduğunu hatırlayın. Bir kereden fazla ve/veya birden fazla insana sormaktan çekinmeyin. Gözardı edilmiyorsunuz. Eğer ihtiyacınız olan yardımı alamıyorsanız, MDN şefi Eric Shepherd ile temasa geçin. Bizim için katılımcılara yardımcı olmaktan önemli hiçbir şey yoktur.
  • Herkes herşeyi değiştirebilir. Hiçkimse onun içeriğini değiştirdiğiniz için alınmamalıdır, ve siz de birisi içeriğinizi değiştirdiği için alınmamalısınız (öte yandan değişiklikler hakkında soru sormaktan da çekinmemelisiniz). Değişiklikler eleştiri değildir, (neredeyse her zaman) yapıcı iyileştirmelerdir.
  • Konu başlıkları için yönlendiricilerimiz var. Eğer belli bir konu üerinde çalışıyorsanız, size yardımcı olabilirler.

Hızlı Başlangıç rehberi

Log in

MDN kimlik doğrulama için Persona kullanır. Bir Persona hesabı oluşturun ve MDN'e login olun.

Uygulama yapın

Bir öğrenme ve deneme alanı olan Sandbox'ta wiki becerilerinizi geliştirin.

Bir sayfayı değiştirin

  1. Herhangi bir sayfanın üstündeki "Edit" düğmesine basın.
  2. Değişikliklerinizi yapın. Değişikliklerinizin nasıl göründüğünüzü gormek için "PREVIEW CHANGES" düğmesine basın.
  3. Değişiklik arayüzünden çıkmadan değişikliklerinizi kaydetmek için  "SAVE AND KEEP EDITING" düğmesine basın. Sayfayı kaydetmek ve değişiklik arayüzünü kapatmak için "SAVE CHANGES" düğmesina basın. Sayfanın orjinal versiyonuna geri dönmek için "DISCARD CHANGES" düğmesine basın.

Eğer browser'ınız yönlendirici bilgisi göndermeyecek şekilde ayarlandıysa, bir "Permission Denied" hatası alırsınız ve değişikliklerinizi kaydedemezsiniz. Eğer değişikliklerinizi Firefox'ta kaydedemiyorsanız, network.http.sendRefererHeader seçeneğinin varsayılan degerde olduğundan emin olun (şu anda "2" dir).

Yeni bir sayfa oluşturun

Eğer yeni bir yazıyı nereye koyacağınızı bilemiyorsanız, endişelenmeyin! Herhangi bir yere koyun, biz onu bulur ve ait olduğu yere taşırız, ya da en mantıklı içerikle birleştiririz. Aynı zamanda, mükemmel olması için endişe etmenize de gerek yok. İçeriğinizi daha temiz ve tatlı yapacak yardımcı cücelerimiz var.

Varolan bir sayfaya linkleyin

  1. Bir sayfanın metni içinde herhangi bir yerde yeni sayfanın adını yazın.
  2. İsmi seçin ve editörün araç çubuğundaki Link ikonuna tıklayın  (). "İlişki Kurulacak Yer" alanında seçili metin olacak şekilde "İlişkiyi Güncelle" diyaloğu açılır.
  3. URL alanının başında öntanımlı olarak "/en-US/docs/" gelecektir. "/en-US/docs/" dan sonra sayfanın adını yazın. (Sayfanın adının ilişki kurulan metinle aynı olması gerekmez.)
  4. İlişki kurmak ve tanımlamak için OK'e tıklayın.

Eğer sayfa mevcut değilse ilişki kırmızı olacaktır. Sayfa zaten varsa, ilişki mavi olacaktır. Eğeryeni bir sayfa oluşturmak istiyorsanız, ama istedğiniz sayfa başlığı çoktan alınmışsa, önce zaten orada olan sayfayı değiştirmek ya da geliştirmenin daha mantıklı olup olmadığını değerlendirin. Değilse, kendi sayfanıza yeni bir sayfa adı düşünün ve ona doğru bir ilişki kurun. Sayfa isimlendirme rehberinden size yol göstermesi için faydalanabilirsiniz.

Yeni sayfanıza içerik eklemek için, (editörde kaydedip kapattıktan sonra) az önce oluşturduğunuz kırmızı ilişkiye tıklayın ve yazmaya başlayın. Değişiklik arayüzünü kapatmadan değişikliklerinizi kaydetmek isterseniz "KAYDET VE DEĞİŞTİRMEYE DEVAM ET" e tıklayın. İşiniz bitince "DEĞİŞİKLIKLERİ KAYDET" e basın.

İlişki kurmadan yeni sayfa

Başka bir sayfadan ilişki kurmadan yeni bir sayfa oluşturmak için, browser'ınızda URL alanına eşi olmayan bir URL girin. Örneğin, şunu girerseniz:

https://developer.mozilla.org/en-US/docs/FooBar

... MDN FooBar adında yeni bir sayfa oluşturur ve yeni sayfaya içerik ekleyebilmeniz için editörü açar.

Wiki biçimlendirme

Kuma, Mozilla tarafından Mozilla Developer Network'ün kullanımı için geliştirilmiş yazılım, dokümantasyon için biçimlendirme dili olarak HTML kullanır. Eğer HTML içeriği görmek ya da değiştirmek istiyorsanız, değiştirme modundayken araç çubuğundaki "Kaynak" düğmesine basarak yapabilirsiniz. WYSIWYG editörüne dönmek için tekrar tıklayın.

Dokümantasyon hatalarını kayıt altına almak

Karmaşık sorunlari bir dokümantasyon hatası kaydederek raporlayabilirsiniz. Asağıdaki alan değerlerini kullanın:

product
Mozilla Developer Network
component
Dokümantasyon isteği
URL
Sorunu bulduğunuz sayfa
Description
Sorunu tarif etmek ve doğru bilginin derede bulunabileceğine dair bildiğiniz ya da zamanınızın yettiği kadarı. Bu insanları olduğu kadar ağ ilişkilerini de içerebilir.

Eski dokümantasyonu taşımak

MDN'de uzun süredir devam eden bir alt-proje de mozilla.org web sayfasında bulunan nevcut geliştirme dokümanlarının hepsini MDN wiki'ye taşımak hakkındadır. Prosedür oldukça basittir:

  1. Varolan içerik listesinden taşımak istediğiniz dokümanı seçin.
  2. İsimlendirme rehberinden faydalanarak wiki'deki dokümanda sayfa ya da sayfaların nasıl adlandırılacağına karar verin.
  3. Bu sayfaları oluşturun ve wiki biçimlendirme rehberinden faydalanarak en iyi şekilde biçimlendireceğiniz içeriği taşıyın.
  4. Nesneyi varolan içerik listesinden silin.
  5. Nesneyi yönlendirmeye ihtiyaç var listesine ekleyin.

Bu konuda kapsamlı bir iş yapmakta kararlıysanız şunları da yapın:

  1. Wiki'de orjinal dokümana işaret eden bağlantıları bulmak için bizim arama sistemini kullanın, sonra bu linkleri yeni wiki sayfasını işaret edecek şekilde değiştirin.
  2. Orjinal dokümana dışarıdan yönlenmiş bağlantıları kontrol edin ve onları "Junk" şeklinde etiketleyerek silinmek için işaretleyin.

MDN'i yerelleştirmek

Eğer MDN wikilerinin herhangi birindeki bir dokümanı tercüme etmekle ilgileniyorsanız, söz konusu dilin wiki'sini ziyaret edin ve sayfa oluşturun ya da değiştirin. Mevcut projeler hakkında bilgi almak ya da yeni bir proje başlatmak için Yerelleştirme projeleri'ne bakın.

"Değişiklik Savaşları" nı ve diğer çatışmaları çözmek

Eğer herhangi bir sebeple kendinizi bir sayfa üzerinde "değişiklik savaşı"nda bulursanız, iki ya da daha fazla kişi sürekli ve tekrarlı şekilde değişiklik yapıyor ve değişiklikleri geri alıyorsa, lütfen önce çatışmayı karşınızdaki insanlarla çözmeye çalışın.

Çözüm mümkün olmazsa, lütfen konuyu MDN mail listesinin ya da (son çare olarak) dgeliştirme dokümantasyon yönetiminin dikkatine sunun. Diğer teknik uzmanlar, yazarlar ve editörlere danışılacak ve uzmanlıklarından sorunu çözmek için faydalanılacaktır..

Sayfa silinmesi talepleri

Eğer kazara bir sayfa oluşturur ya da silinmesi gerektiğini düşündüğünüz bir sayfayla karşılaşırsanız, "Junk" olarak etiketleyin.

Junk olarak etiketlenmiş nesneler wiki yöneticileri tarafından periyodik olarak kontrol edilir ve uygun olduğunda ilgili sayfalar değerlendirilir ve silinir.

Not: Lütfen "Junk" olarak işaretlediğiniz sayfalardaki diğer içerik ya da kategorileri silmeyiniz.
 
 
Hazırlayan: Maheswaran Shenthuran

 

Attachments

Dosya Size Date Attached by
Link icon
The link icon from the toolbar
3865 bytes 2012-08-03 07:25:01 Sheppy

Document Tags and Contributors

Contributors to this page: uksonal
Last updated by: uksonal,