@aglyn/aglyn 1.0.0-beta.289 → 1.0.0-beta.290

package/src/lib/app-utils/docs-index.generated.js

@@ -5161,7 +5161,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Fulfillment, returns and webhooks',
         heading: 'Invoices and packing slips',
         anchor: '#invoices',
-        text: 'Invoice in the order\'s dialog opens the order as a bill, ready to print: your business name, the date, who it is billed and shipped to, each line with its unit price, the subtotal, discount, shipping, tax and total, and anything refunded. Your store\'s receipt footer and terms address print at the foot. To keep a PDF, choose Save as PDF in the print dialog.\nPacking slip prints what goes in the box — the shipping address and each line\'s quantity, name, option and SKU — with no prices.'
+        text: 'Invoice in the order\'s dialog has two choices:\n- Print invoice opens the order as a bill, ready to print: your business name, the date, who it is billed and shipped to, each line with its unit price, the subtotal, discount, shipping, tax and total, and anything refunded. Your store\'s receipt footer and terms address print at the foot.\n- Download PDF saves the same invoice as a PDF file in your site\'s look: your logo and contact details at the top, a band in your site\'s primary color, the invoice number, the order date and whether it is paid, then the lines and totals. A paid quote\'s invoice works the same way, with Included beside anything included at no charge.\nThe PDF takes your logo and contact details from your site\'s settings, and its colors from your site\'s theme. Downloading it takes the Manage orders permission.\nPacking slip prints what goes in the box — the shipping address and each line\'s quantity, name, option and SKU — with no prices.'
     },
     {
         path: '/commerce-and-bookings/commerce/orders-and-returns',
@@ -5630,7 +5630,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Quotes',
         heading: 'What a quote holds',
         anchor: '#what-a-quote-holds',
-        text: '- The customer. When your workspace keeps contacts, find someone by name, email or phone; or type their name, company, email and phone. A contact keeps the quote tied to their record.\n- Items. Any mix of:\n- Products from your catalog, with the option you pick and any add-ons the product offers. They are priced from the product, add-ons included, exactly as the point of sale prices them.\n- Custom items, typed for this job: a name, an optional description and SKU, a unit price and a quantity. Turn off Ships for work that doesn\'t ship, such as design or installation. A custom item never changes your stock.\n- Included items. Turn on Included at no charge for anything that comes with the order, a product or a custom item, and it is listed at no charge.\n- Discount: an amount off, or a percent off the items.\n- Shipping: the amount you charge to ship it. Leave it empty when nothing ships.\n- Ship to and Bill to addresses.\n- Notes for the customer and Terms.\nEach quote also keeps whether Customers approve the proof before they can pay. When it is on and the quote has a proof the customer hasn\'t approved, the customer\'s page asks them to approve it instead of offering Pay, and a payment can\'t be started for it. A quote with no proof is never held.'
+        text: '- The customer. When your workspace keeps contacts, find someone by name, email or phone; or type their name, company, email and phone. A contact keeps the quote tied to their record.\n- Items. Any mix of:\n- Products from your catalog, with the option you pick and any add-ons the product offers. They are priced from the product, add-ons included, exactly as the point of sale prices them.\n- Custom items, typed for this job: a name, an optional description and SKU, a unit price and a quantity. Turn off Ships for work that doesn\'t ship, such as design or installation. A custom item never changes your stock.\n- Included items. Turn on Included at no charge for anything that comes with the order, a product or a custom item, and it is listed at no charge.\n- Discount: an amount off, or a percent off the items.\n- Shipping: the amount you charge to ship it. Leave it empty when nothing ships.\n- Ship to and Bill to addresses.\n- Notes for the customer and Terms.\nEach quote also keeps whether Customers approve the proof before they can pay. When it is on and the quote has a proof the customer hasn\'t approved, the customer\'s page asks them to approve it instead of offering Pay, and a payment can\'t be started for it. A quote with no proof is never held. See Proof approval and paying.'
     },
     {
         path: '/commerce-and-bookings/commerce/quotes-and-proofs',
@@ -5665,7 +5665,42 @@ export const DOCS_SECTION_INDEX = [
         title: 'Quotes',
         heading: 'What your customer sees',
         anchor: '#customer-page',
-        text: 'The pay link opens the quote inside your site\'s own header and footer:\n- your business name, the quote number and its date;\n- who it is for, and the bill-to and ship-to addresses;\n- each item with its option and add-ons, description, SKU, quantity and price, and Included beside anything included at no charge;\n- the discount, shipping, tax and total, or Tax is added at payment when Stripe Tax works the tax out;\n- your notes and terms.\nThe page is private: search engines don\'t list it, and it never shows the customer\'s email or phone number, your notes to yourself or who on your team wrote the quote.'
+        text: 'The pay link opens the quote inside your site\'s own header and footer:\n- your business name, the quote number and its date;\n- who it is for, and the bill-to and ship-to addresses;\n- each item with its option and add-ons, description, SKU, quantity and price, and Included beside anything included at no charge;\n- the discount, shipping, tax and total, or Tax is added at payment when Stripe Tax works the tax out;\n- your notes and terms.\nThe page is private: search engines don\'t list it, and it never shows the customer\'s email or phone number, your notes to yourself or who on your team wrote the quote.\nDownload PDF on the page saves the quote as a PDF file, so your customer can keep it, print it or pass it on. The download works only from the quote\'s current link.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'Attach proofs',
+        anchor: '#proofs',
+        text: 'A proof shows your customer what they\'re getting before you make it: the canopy with their logo on it, the sign laid out at size. Attach proofs to a saved quote, and your customer sees them on the quote page, where they approve them or ask for changes.\n1. Open the quote and find Proofs in the editor.\n2. Choose Add proof and pick one or more files.\nA proof can be a PNG, JPEG, WebP, GIF, PDF, SVG, AI, EPS, PSD or TIFF file, up to 25 MB each, and a revision holds up to 10. Images show as pictures, and the other files as a chip with the file\'s name and size. Choose a picture or a chip to download the file.\nEvery file is checked before it\'s kept: a file whose contents aren\'t what its name says, or that carries a program, isn\'t taken, and an SVG is stripped of anything that could run. Proofs are kept privately with the quote. Only your team and the holder of the quote\'s link can open them, and never through a public address.\nTo take a proof off, choose Remove under it. You can add and remove proofs until your customer answers. After that, start a new revision to send different proofs.\nAdding or removing a proof changes what your customer sees, so it counts as an edit: a customer who has the page open is asked to look again before they answer or pay.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'What your customer sees of the proofs',
+        anchor: '#customer-proofs',
+        text: 'When the current revision has proofs, the quote page shows them under the quote: each image as a picture and every other file as a download. Beside them are two choices:\n- Approve this proof. Your customer types their name and chooses Approve. The quote keeps their name, the time, and the address and browser it came from, as the record of the approval, and moves to Approved.\n- Request changes. Your customer says what should change, and can attach their own artwork: up to 10 files of the same kinds and size as proofs. The quote moves to Changes requested, with their comment and files.\nThe latest answer is the one that counts. A customer who asked for changes can still approve, and one who approved can still ask for changes, which withdraws the approval. The page tells them what they last said.\nYou\'re notified of every answer, in the console and by email, with the quote, the customer, the revision and what they said. The notice opens the quote, and replying to the email reaches your customer.\nA paid quote still shows its proofs, with nothing to press. A link you replaced shows nothing of the quote, proofs included, and takes no answer.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'Proof approval and paying',
+        anchor: '#approval-and-paying',
+        text: 'Whether paying waits on the approval is up to you, quote by quote, with Customers approve the proof before they can pay (the new-quote default sets where each quote starts):\n- On: while the current revision has a proof your customer hasn\'t approved, the quote page shows a short line asking them to approve it in place of Pay, and no payment can be started. Approving brings Pay back. A new revision with new proofs needs its own approval.\n- Off: Pay is always there. Your customer can approve or ask for changes, and paying never waits on it.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'Revisions',
+        anchor: '#revisions',
+        text: 'A quote\'s revision is the version your customer is looking at, starting at Revision 1. When your customer asks for changes, or you want to send different proofs, start the next one:\n1. Open the quote and choose Start revision 2 (or whichever comes next) under Proofs.\n2. Confirm.\nThe revision you had is kept exactly as it stood: its items and totals, notes and terms, its proofs, and every answer your customer gave it. The new revision starts with no proofs and no answer, back at Draft, ready for new proofs and any changes to the quote. Every earlier revision is listed under Earlier revisions in the quote, with its status, its proofs and your customer\'s comments and files, read-only.\nA paid quote takes no new revision. A quote that has earlier revisions can\'t be deleted, because your customer saw them.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/quotes-and-proofs',
+        title: 'Quotes',
+        heading: 'Download a quote as a PDF',
+        anchor: '#pdf',
+        text: 'Open a saved quote and choose Download PDF. The PDF is the quote your customer sees, set out as a document in your site\'s look:\n- your logo, business name, address, email, phone and web address at the top, under a band in your site\'s primary color;\n- Quote # with its number, the date it was last saved and its revision;\n- the bill-to and ship-to addresses;\n- each item with its option and add-ons, description, SKU, quantity, unit price and amount, and Included beside anything included at no charge;\n- the discount, shipping, tax and total, or Tax is added at payment when Stripe Tax works the tax out;\n- the pay link, as a button and as an address your customer can click, while the quote is still to be paid;\n- your notes and terms.\nOnce the quote is paid, the PDF says Paid with the date, and has no pay link.\nThe logo and contact details come from your site\'s settings, and the colors from your site\'s theme. A quote with more items than fit on a page runs onto the next, with the item headings repeated and each page numbered. The PDF shows the quote as it was last saved, so save your changes first.\nThe pay link is printed on the PDF only for someone who can also send quotes (see who can make and send quotes); for anyone else the PDF leaves it off.'
     },
     {
         path: '/commerce-and-bookings/commerce/quotes-and-proofs',
@@ -5693,7 +5728,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Quotes',
         heading: 'Who can make and send quotes',
         anchor: '#permissions',
-        text: 'Making, editing and deleting quotes takes the Create and edit quotes permission. Copying and replacing a quote\'s pay link takes Send quotes and invoices to customers. Everyone who can manage orders on the site has both to start with; a custom role or a per-member override can grant or deny each one. See Order permissions.'
+        text: 'Making, editing and deleting quotes, adding and removing proofs, starting a revision, seeing earlier revisions and your customer\'s files, and downloading a quote\'s PDF, takes the Create and edit quotes permission. Copying and replacing a quote\'s pay link takes Send quotes and invoices to customers, and so does a PDF that carries the pay link. Everyone who can manage orders on the site has both to start with; a custom role or a per-member override can grant or deny each one. See Order permissions.'
     },
     {
         path: '/commerce-and-bookings/commerce/review-platforms',