Endpoints and objects

Apply bold formatting when naming endpoints or other objects, even if it’s also a hyperlink and won’t appear bold to a user. Amid so much text, we want to user to be able to quickly pick out these elements when scanning. When we bold all endpoints and objects, the user will see either a blue hyperlink or bold, black text, both of which readily stand out.

Examples

• Use the getQuotableProducts endpoint.
• Obtain a quote’s details by using the endpoint getQuote.

Code

When including code in a sentence, always use code formatting. Use code formatting for all inline references, not just code blocks. Always use code formatting for elements such as IDs and other code-related tags, elements, parameter names, etc.

Examples

• Use the getQuotableProducts endpoint (/quote/quotable-products/) to view the list of products (lines of business, or LOB) available for quoting.
• quote_number is the required parameter.
• Save the id as vehicle_id.

Incorrect examples

• Use the getQuotableProducts endpoint (/quote/quotable-products/) to view the list of products (lines of business, or LOB) available for quoting.
• Quote number is the required parameter.
• Save the id as vehicle id.

Note: You can place lowercase code elements at the beginning of a sentence.

To apply code formatting, select the text you want to apply code formatting to, and then press control + option + x (Mac) or ctrl + alt + x (Windows) on your keyboard.

Note: Apply code formatting only to the text, not the spaces before or after the element. Be mindful of this as you apply your formatting.

Code blocks

Make long blocks of code expandable/collapsible using the expand title function so readers can easily scan content when they arrive on a page.

• Use this consistently on each page; if one code block is collapsible, make them all collapsible.
• Set the title to View code. Set the swaptitle to Hide code.
• Include the following disclaimer, in block quote formatting, a single time at the beginning of any section or page (at your discretion) to explain the element to the reader:

Note: Blocks of code are hidden by default to make the page more navigable. Select View code and Hide code to view or hide these sections as needed.

Sample code block

Expand element

Note: Type this element directly in the Visual editor; this isn’t HTML, so you don’t need to use the WordPress Text editor.

Details

Use the details tag to create expandable/collapsible text to make lengthy pages more navigable. Don’t use this for code; for code, use the convention described above.

• You can use details with any kind of text or content.
• The Details element is what creates the expandable text; the Summary tag gives it a title.
• Make the title text bold. You can do this in the Visual or Text editors.
• In the live post, select/unselect the text to display/hide the content.

Sample details section

View additional details on Item Range

Dependencies

• Non-Prepared property_items
• Non-prepared revision_items
• Prepared item_transactions

Facts

• annualPremium
• itemEarnedPremium
• itemEndingLimit
• itemEndingPremium
• itemStartingLimit
• itemTransactionType
• itemWrittenPremium

Table 7 summarizes what’s included in Item Range. Table 7: Item Range.

Column Name	Description	Type
annualPremium	The premium amount over a year for the policy.	float
itemEarnedPremium	The amount of premium that was earned for a particular item over the date range specified.	float
itemEndingLimit	The limit at the end of the range, even if the policy was canceled during the date range.	float
itemEndingPremium	The premium at the end of the range, even if the policy was canceled during the date range.	str
itemId	A foreign key to items.	str
itemStartingLimit	The limit at the beginning of the range.	float
itemTransactionType	The type of premium transaction that occurred on the item.	str
itemTransactionalCustomFees	The change in a particular custom fee over the date range specified.	float
itemWrittenPremium	The amount of premium that was written for a particular item over the date range specified.	float
lastItemTransactionDate	The date of the last transaction that occured within the specified date range.	date
policyId	A foreign key to properties.	str
propertyId	A foreign key to properties.	str
reportingDate	Date of report.	date
revisionId	The foreign key that binds nearly everything.	str

Apply details tag

Note: Type this element in the Text editor; this is HTML, so you must use the WordPress Text editor. The easiest way is to type the text you want to hide in the Visual editor, then place the details tags before and after it in the Text editor.