LogoLogo
Enterprise GuideCommunity Edition GuideDeveloper Guide
  • Using The Polarity Developer Guide
  • Quick Start
    • What's New
    • Installing Integrations
    • Quick Start Guide
    • Learning Resources
  • Building an Integration
    • Directory Layout
    • package.json
    • Configuration File
    • Integration Main Module
      • startup
      • doLookup
        • Entity Objects
        • Result Objects
        • Error Objects
      • onDetails
      • onMessage
      • validateOptions
    • Customizing the Overlay Window
      • Templates
        • Conditionals
        • Displaying a List of Items
        • Display Object Properties
        • Built-in Helpers
        • Displaying Icons
      • Component File
        • Aliased Properties
        • Computed Properties
        • Event Hooks
      • CSS Styles
    • Vendor Javascript
      • Inserting Javascript into DOM
    • README Guide
    • Debugging Integrations
      • Web Inspector
      • Using Integration Logs
      • Testing Main Module
  • Recipes
    • Enabling User Actions
    • Throttling Lookups
    • Using Custom Entity Types
    • Custom Summary Tags
    • Creating a Tabbed Interface
    • Accessing Username of Requestor
Powered by GitBook
On this page
  • Directory Location
  • Summary
  • Suggested Information
  • Author
  • Overview
  • User Options
  • Developer Notes
  1. Building an Integration

README Guide

PreviousInserting Javascript into DOMNextDebugging Integrations

Last updated 5 years ago

Directory Location

sample-integration/
└── README.md

Summary

The README.md file is a markdown file that provides a detailed overview of the integration. The README.md file should be written using GitHub flavored markdown. You can learn more about markdown syntax by reading the "" guide on GitHub.

Suggested Information

We recommend providing the following information in your README.md file.

Author

Who developed the integration?

Overview

A brief overview of what the integration does. What data does it connect to and what does it display? What are the requirements for using the integration? Including a screenshot of the Overlay Window is a great way to provide a quick sense of the information displayed.

User Options

What options does the integration expose to the end user? Which options should be admin only and which are per user?

Developer Notes

Any notes for developers looking to fork or submit pull requests for your integration.

Mastering Markdown