trafficcontrol icon indicating copy to clipboard operation
trafficcontrol copied to clipboard

Docs for ISO generation are missing optional properties

Open ocket8888 opened this issue 2 years ago • 3 comments

This Bug Report affects these Traffic Control components:

  • Documentation

Current behavior:

The docs for the /isos TO API endpoint in all versions are missing descriptions for the following optional request properties:

  • mgmtIpAddress - management interface IP address
  • mgmtIpNetmask - management interface IP netmask
  • mgmtIpGateway - management interface gateway IP address
  • mgmtInterface - management interface network interface device name

Expected behavior:

Documentation should be complete and accurate.

Steps to reproduce:

Read the docs

ocket8888 avatar Feb 22 '23 22:02 ocket8888

hey can i work on this. I am new to OS. Where do i start? Reading the docs and then?

Exar04 avatar Feb 27 '23 20:02 Exar04

Our documentation lives under doc/source/ and can be built using make from within doc/ (see the documentation section on building the documentation). The API documentation is in docs/source/api/ which has subdirectories for each API version (v3, v4, and v5) which each contain a file describing the /isos endpoint that is missing the above property descriptions.

ocket8888 avatar Feb 28 '23 20:02 ocket8888

As no one else is currently working on this, I have started working on the issue. Will open a PR soon.

AdityaMayukhSom avatar Dec 26 '23 07:12 AdityaMayukhSom