Uzantınız için kullanıcı dokümanları oluşturun

Her uzantının kullanıcılara uzantının ne yaptığını ve nasıl kullanılacağını öğreten dokümanlara sahip olması gerekir.

Gerekli minimum dokümanlar, aşağıdaki üç Markdown dosyasından oluşur:

• PREINSTALL.md
• POSTINSTALL.md
• CHANGELOG.md

Ayrıca şunları da üretebilirsiniz:

• Uzantının herkese açık deposu için bir README dosyası.
• Kendi web sitenizde yayınlanan ve PREINSTALL.md bağlantısında yer alan daha uzun eğitici içerikler, kılavuzlar ve referanslar.

En iyi uygulamalar, yaygın ifade ve yapıları öğrenmek için resmi Firebase uzantılarıyla kullanılabilen dosyaları incelemenizi öneririz.

README dosyası oluşturma

Uzantı dizininiz isteğe bağlı olarak bir BENİOKU dizini içerebilir. firebase ext:dev:init komutunun sizin için otomatik olarak bir tane oluşturmadığını unutmayın.

Bununla birlikte, Firebase CLI, extension.yaml dosyanızdan ve PREINSTALL.md dosyanızdan alınan içeriği içeren bir README dosyasını otomatik olarak oluşturmak için aşağıdaki kolaylık komutunu destekler:

firebase ext:info ./path/to/extension --markdown > README.md

Resmi Firebase uzantılarının tüm BENİOKU dosyaları bu komut kullanılarak oluşturulur.

Kurulum bilgileri ekleme

README dosyasını yazdıktan veya oluşturduktan sonra yükleme bilgilerini ekleyin. Aşağıdaki snippet'i şablon olarak kullanabilirsiniz:

---

## 🧩 Install this extension

### Console

[![Install this extension in your Firebase project](https://www.gstatic.com/mobilesdk/210513_mobilesdk/install-extension.png "Install this extension in your Firebase project")][install-link]

[install-link]: https://console.firebase.google.com/project/_/extensions/install?ref=publisher_id/extension_name

### Firebase CLI

```bash
firebase ext:install publisher_id/extension_name --project=[your-project-id]
```

> Learn more about installing extensions in the Firebase Extensions documentation:
> [console](https://firebase.google.com/docs/extensions/install-extensions?platform=console),
> [CLI](https://firebase.google.com/docs/extensions/install-extensions?platform=cli)

---

PREINSTALL dosyası yazılıyor

PREINSTALL dosyası, uzantınızın genel bakışıdır ve bir tür "pazarlama" sayfasıdır.

Bu dosyada hangi içerik var?

• Uzantı işlevinizin kapsamlı açıklaması
• Veritabanı kurulumu veya Google dışı bir hizmete erişim gibi ön koşulların listesi (örnek)
• Kurulum öncesi görevlerin kısa açıklaması ve talimatları
• Yükleme sonrası görevlerin kısa açıklaması (örnek) (ayrıntılı talimatlar POSTINSTALL içindedir)
• Faturalandırmayla ilgili sonuçların kısa açıklaması (standart metin ile başlayın)

Bu içerik kullanıcıya nerede gösteriliyor?

Firebase konsolu">

Firebase konsolu">

• extensions.dev adresindeki uzantının sayfasında.
• Uzantınıza ait kaynak kod deponuzdan (uzantı dizininde)
• Uzantının README dosyasında (Firebase CLI --markdown > README.md işaretini kullanıyorsanız)

PREINSTALL dosyaları, uzantının parametre değerlerine erişemez. Bu nedenle, parametre referanslarının gerçek değerlerle oluşturulmasını bekleyemezsiniz.

Bu konudaki en iyi uygulamalardan bazıları nelerdir?

• Mümkünse PREINSTALL dosyasının tüm içeriğini bir sayfanın altında tutun
• Uzantıyı yüklemeden önce son kullanıcının mutlaka bilmesi gereken ayrıntı düzeyini sağlayın
• Ayrıntılı talimatları POSTINSTALL dosyasına veya diğer ek dosyalara yerleştirin.
• Uzantıyı destekleyecek başka araçlar veya komut dosyaları sağlayıp sağlamadığınızı kısaca belirtin.

Billing

This extension uses other Firebase or Google Cloud services which may have
  associated charges:

*   <list Google services / products that your extension uses>
*   <list Firebase services that your extension uses>
*   Cloud Secret Manager <if the extension uses secret params>
*   Cloud Functions

When you use Firebase Extensions, you're only charged for the underlying
resources that you use. A paid-tier billing plan is only required if the
extension uses a service that requires a paid-tier plan, for example calling to
a Google Cloud API or making outbound network requests to non-Google services.
All Firebase services offer a no-cost tier of usage.
[Learn more about Firebase billing.](https://firebase.google.com/pricing)

<Applicable info about billing implications for non-Google services, such as:>
Usage of this extension also requires you to have a <non-Google-service> account.
You are responsible for any associated costs with your usage of <non-Google-service>.

POSTINSTALL dosyası yazma

POSTINSTALL dosyası, uzantınızın ayrıntılı yükleme sonrası eğitim sayfasıdır.

Bu dosyada ne tür bir içerik var?

• Firebase güvenlik kurallarını ayarlama veya istemci tarafı kod ekleme gibi zorunlu kurulum sonrası görevler için ayrıntılı talimatlar (örnek)
• Yüklenen uzantıyı hemen denemeye yönelik genel talimatlar (örneğin, "Konsola gidin ve bunu yapın")
• Özellikle HTTP isteği tarafından tetiklenen uzantılar için uzantının nasıl tetikleneceği hakkında temel bilgiler
• Yüklenen uzantının nasıl izleneceğine dair kısa talimatlar (standart metin ile başlayın)

Bu içerik kullanıcıya nerede gösteriliyor?

Firebase konsolu">

Firebase konsolu">

• Bir kullanıcı uzantınızı yükledikten sonra Firebase konsolunda (yüklü uzantının ayrıntı kartında)

  • Uzantılarınızı gerçek bir projeye yükleyerek POSTINSTALL içeriğinin görüntülenmesini inceleyin.

• Uzantınız için kaynak kodu deponuz (uzantı dizininin içinde)

POSTINSTALL dosyaları, uzantı için parametre değerlerine ve işlevle ilgili çeşitli değişkenlere erişebilir. POSTINSTALL içeriği Firebase konsolunda görüntülendiğinde parametre veya değişken referansları yerine gerçek değerler gösterilir. POSTINSTALL dosyanızda parametrelere ve değişkenlere referans verme hakkında daha fazla bilgiyi aşağıda bulabilirsiniz.

Bu konudaki en iyi uygulamalardan bazıları nelerdir?

• POSTINSTALL dosyasının tüm içeriği kısa ve öz ancak açıklayıcı olmalıdır.
• Farklı görevleri veya kavramları ayırmak için başlıkları kullanarak içeriği bölümlere ayırın.
• Web sitenizde (örnek) veya uzantı deposundaki ek Markdown dosyalarında (örnek) belirli bir iş akışı ya da görev için ayrıntılı talimatlar yayınlamayı deneyin.
• Kullanıcının yapılandırılmış değerleri talimatlar bağlamında görebilmesi için parametrelere ve işlevle ilgili değişkenlere referans verin.

Parametrelere ve değişkenlere referans verme

Yükleme işleminden sonra Firebase konsolu, uzantının POSTINSTALL dosyasının içeriğini gösterir. POSTINSTALL dosyanızda parametrelere ve işlevle ilgili değişkenlere (aşağıdaki tabloya bakın) referans verirseniz konsol bu referansları, yüklü örneğin gerçek değerleriyle doldurur.

Aşağıdaki söz dizimini kullanarak POSTINSTALL dosyasında yapılandırılmış parametre değerlerine erişin: ${param:PARAMETER_NAME}

Aşağıdaki işlevle ilgili değişkenlere yalnızca POSTINSTALL dosyanızda de referans verebilirsiniz. Firebase, yükleme sonrası kullanıcılarınıza daha kolay yol gösterebilmeniz için bu değişkenleri destekler. Bu değişkenlerin değerleri yükleme işleminden sonra kullanılabildiği için yalnızca POSTINSTALL dosyasında kullanılabilirler.

Bu tabloda function-name, işlevin extension.yaml içindeki kaynak nesnesinde bulunan name alanının değeridir.

Monitoring

As a best practice, you can
[monitor the activity](https://firebase.google.com/docs/extensions/manage-installed-extensions_community#monitor)
of your installed extension, including checks on its health, usage, and logs.

Uzantıların nasıl tetikleneceğini belgeleme

Uzantı kullanıcı dokümanlarınızda, kullanıcılarınıza uzantınızı nasıl tetikleyecekleri konusunda talimat vermeniz gerekir. Bu talimatlar, gerekli olduğunu düşündüğünüz kadar ayrıntılı olabilir ancak POSTINSTALL dosyası yazmayla ilgili en iyi uygulamaları göz önünde bulundurun. Bu talimatların nasıl sağlanacağıyla ilgili yardım almak için aşağıda uzantınız için geçerli olan bölümü genişletin.

CHANGELOG dosyası yazma

Bu dosyada ne tür bir içerik var?

Her uzantının, yayınladığınız her yeni sürümünde yapılan değişiklikleri belgeleyen bir CHANGELOG.md dosyası olmalıdır. Her sürümü 2. düzey bir başlığın (##) altına koyun. Dilerseniz istediğiniz Markdown biçimlendirmesini kullanabilirsiniz.

Aşağıdaki örnek, resmi uzantılardan birinden alınmıştır:

## Version 0.1.3

feature - Support deletion of directories (issue #148).

## Version 0.1.2

feature - Add a new param for recursively deleting subcollections in Cloud
Firestore (issue #14).

fixed - Fixed "cold start" errors experienced when the extension runs after a
period of inactivity (issue #48).

## Version 0.1.1

Initial release of the _Delete User Data_ extension.

Bu içerik kullanıcıya nerede gösteriliyor?

• Firebase konsolunda ve CLI'de, kullanıcılar uzantınızın yeni sürümlerine yükselttiğinde. Firebase Konsolu ve CLI, yalnızca kullanıcı yükseltmeyi tamamlarsa geçerli olacak değişiklikleri gösterir.
• Uzantınızın kaynak kodu deposu (uzantı dizininde).