NASA-AMMOS / NASA-AMMOS/MMGIS

[Documentation]: Docs for Agentic Administrator.

Open
#1,068 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

documentation good first issue
Dominant language
JavaScript
Stars
232
Forks
77
Avg merge
3d 6h
Merged PRs (30d)
17

Description

Currently a lot of MMGIS' new documentation is tailored for an Agentic Developer, one setting up MMGIS, developing new plugins, and so on. Another persona an agent may take is that of an administrator and the agent-specific documentation for that role is far less developed. For instance: asking AI to stand up a new mission and just include the following DEM (https://zenodo.org/records/22164484) is not as smooth as it could be:

  • The agent does not know it has to look at a series of plugin jsons to know how to construct a config json object.
  • The agent does not immediately know that it should be in a non-coding capacity
  • While the agent knows how to setup MMGIS, over longer sessions it often forgets its admin password to the /configure and has to waste time trying to reset it in the database
  • How to configure projections was less clear to the agent in the case of the DEM above (it did not know Venus projection tilematrixset were already provided via planetcantile)
  • and so on.

I good way to generate adequate documentation for an administrator roles may be to have a lead agent spawn child agents in waves and give each child agent the task of setting up a different new mission with different dataset and report back pain points and keep iterating until child agents can, near-zero shot, quickly configure a variety of new and existing missions.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the existing Agentic Developer documentation and the administrator workflows around mission setup, /configure authentication, plugin JSONs, config JSONs, and projection configuration. Validate the guidance by setting up missions with varied datasets, including the linked DEM, and capture the documented steps and pain points until an administrator agent can configure them reliably.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.