Skip to content

Add missing API descriptions

Note

This issue address an existing engineering/technical implementation, and is not strictly focused on documentation

Problem to solve

GitLab's API content is missing attributes descriptions (46 files, 165 missing descriptions).

Proposal

Currently plan is to do this with a small team of technical writers. Deves team to support additional questions.

  • Add missing descriptions
    • Analyze list of files to identify any missing descriptions
    • Compare against existing markdown documentation to reuse content
    • Identify any attributes that need further context from devs
  • Identify any false positives. Files that don't have any missing descriptions.
  • Create a plan for dealing with internal/non-customer facing APIs.

Note

Remember to remove any fixed files from .rubocop_todo/api/parameter_description.yml

Other links/references

Edited by Isaac Durham