Skip to content

docs: Write brand device packs guide #9

@ggfevans

Description

@ggfevans

Summary

Document brand device packs and device library features.

Migrated from: RackulaLives/www#20

Content Outline

Starter Library

  • 43 generic devices included
  • Categories and default devices

Available Brand Packs (19 brands)

  • Power: APC, CyberPower, Eaton
  • Servers: Dell, HPE, Lenovo, Supermicro
  • Networking: Ubiquiti, MikroTik, Netgear, TP-Link, Fortinet, Palo Alto, Netgate
  • Storage: Synology, QNAP
  • Other: DeskPi, BlackMagic

What's in Each Pack

  • Device models included
  • Front and rear images
  • Accurate U dimensions
  • Manufacturer specifications

Importing Device Libraries

  • JSON format for custom libraries
  • Importing from file
  • Library merging behaviour

NetBox Integration

  • Importing from NetBox device library
  • Slug-based device identification
  • Compatible field naming (snake_case)
  • Component data support (interfaces, power, etc.)

Managing Device Libraries

  • Viewing installed devices
  • Adding custom device types
  • Editing device type definitions
  • Deleting unused device types

Contributing Brand Packs

  • How to create a brand pack
  • Required specifications
  • Image guidelines (front/rear)
  • Submission process

Acceptance Criteria

  • Complete brand pack listing with device counts
  • Import instructions for all methods
  • NetBox integration documented
  • Contribution guidelines complete

Test Requirements

  • Build completes without errors
  • Brand list is accurate

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:contentDocumentation contentreadyReady for implementationsize:smallSmall effort

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions