@sentinel-one/ui-compodoc

Angular Document Generator

Usage no npm install needed!

<script type="module">
  import sentinelOneUiCompodoc from 'https://cdn.skypack.dev/@sentinel-one/ui-compodoc';
</script>

README

Angular Document Generator

Installation

  • git clone git@github.com:Sentinel-One/ui-compodoc.git
  • npm i

Execute

  • npm run genDoc:dev or gulp
  • npm run genDoc or gulp --env=prod

File Structure

.
├── common               * share logic\const\templates etc
│   └── gulp             * share gulp utils\paths
│       ├── paths.js     * gulp path for dev\prod
│       └── utils.js     * gulp utils functionality
├── assets               * screen shot\images
├── CHANGELOG.md         * change log details
├── README.md            * readme file
├── gulpfile.js          * gulp task to generate component examples
├── package-lock.json    * project dependencies
├── package.json         * project dependencies
└── test                 * helper for dev

How to Doc

  • add decorator @ComponentDocExample({}) above @Component
  • add the component into entryComponents array in mgmt-ui.module.ts
  • execute gulp task
  • check the demo display

Example

@ComponentDocExample({
  navItem: {
    groupName: 'DATA TABLE',
    exampleName: 'Pagination'
  },
  demos: [
    {
      title:'Example 1'
      inputs: {
          id: 'myId',
          maxVisiblePages: 3,
          totalServerEntities: 1000,
          numOfEntityPerPage: 10,
          showPreviousAndNextText: false
        },
      executeComponentMethod: 'init'
    }
  ]
})

Publish to npm

  • update package.json version
  • push changes to git
  • execute this command npm publish --access public

Screen Shot

Alt text