anchor.diff:  = Catalog Examples
   
  -This document provides some catalog examples and how they affect the invoicing and subscriptions.
  +This document provides examples of catalogs and how they affect  invoices/subscriptions. 
  +
  +Each section in this document corresponds to a particular catalog component and provides examples of catalogs that demonstrate that catalog component. 
  +
  +In each section, subscriptions are created corresponding to the plans in the corresponding catalog. Invoices are generated via the Kaui invoice dry run feature. 
  +
  +== Prerequisites
  +
  +Ensure that you have gone through the https://docs.killbill.io/latest/userguide_subscription.html#components-catalog[Subscription User Guide] and are familiar with the various catalog components like products, plans, phases.
   
   == Billing Modes
   
  -The catalog includes a *Billing Mode* as explained in the https://docs.killbill.io/latest/invoice_subsystem.html[invoicing] document. Quick summary about Billing modes:
  +A catalog needs to include a *Billing Mode* as explained in the https://docs.killbill.io/latest/invoice_subsystem.html#_overview[invoicing] document. 
  +
  +Quick summary about Billing modes:
   
   * Can be specified at the *catalog* level or on a *per-plan* basis.
   * *IN_ADVANCE* indicates that each recurring subscription is charged at the _beginning_ of the billing period.
   
   * *IN_ARREAR* indicates that each recurring subscription is charged at the _end_ of the billing period.
   
  -This section provides examples of catalogs with different billing modes. For simplicity sake, only catalogs with catalog level billing modes are demonstrated below, however the behavior is the same even when a plan level billing mode is used.
  +This section provides examples of catalogs with different billing modes. For simplicity sake, only catalogs with catalog level billing modes are demonstrated below, however the behavior is the same even when a per-plan billing mode is used.
   
   Also, for simplicity sake, all the catalogs demonstrated in this section include a single product (`STANDARD`) and a single plan (`standard-monthly`) corresponding to it.
   
  
positive.code: |===
  |Action   |Result   
  //-------------
  |Create a subscription on `2021-09-17`   |Invoice generated for `$24.95` for  `2021-09-27` to `2021-10-17` since *IN_ADVANCE* billing is used.
  |Trigger invoice dry run with target date `2021-10-17`    |Invoice generated for  `$24.95` for `2021-10-17` to `2021-11-17`  
  |===
  
  
negative.code: 
  === Trial and Monthly Evergreen Phase
  
  This example uses the  https://github.com/killbill/killbill-docs/blob/1a945188c0ef53a3c7f797b4890514d35c09c46f/catalogs/monthly-with-trial.xml[Monthly With Trial] catalog. In this case, the `standard-monthly` plan has a `TRIAL` phase of `10` days followed by an `EVERGREEN` phase with a monthly recurring charge of `$24.95`. So, users will not be charged for the first `10` days after which they will be charged `$24.95` monthly in perpetuity.
  
  [options="header",cols="1,1"]
  |===
  