improve management command docs

[pvgenuchten]

While reading https://docs.geonode.org/en/master/admin/index.html#geonode-management-commands, it is not clear why all calls to python are prepended with DJANGO_SETTINGS_MODULE=geonode.settings. Can you add an intro to the section to explain how management commands can be invoked?

DJANGO_SETTINGS_MODULE=geonode.settings python manage.py updatelayers --help

For the management command update-layers can you add a section to explain what is the actual procedure?

• Does the procedure update all layers, or only the layers which are not present yet
• Does the procedure update also the metadata (update bounds, if bounds have changed on geoserver), update title/abstract/keywords, if they have changed on geoserver.
• Does the procedure remove layers from geonode if they are no longer available on geoserver
• Does geonode also update the geoserver config, to add a back-linkage to pycsw metadata url?

For the import-layers command can you add a section in the doc on how metadata is imported,

• Does geonode import a file.shp.xml as metadata if included on the shapefile? Should the file have a specific metadata format (iso19139?). Or is minimal metadata generated from a template?
• Does the import-layers command go into subfolders?
• What filetypes are supported?

Thank you!

[pvgenuchten]

update-layers

• Does the procedure update all layers, or only the layers which are not present yet? A configuration parameter exists for this --skip-geonode-registered

• Does the procedure update also the metadata (update bounds, if bounds have changed on geoserver), update title/abstract/keywords, if they have changed on geoserver? Yes, new metadata is created for each of the layers

• Does the procedure remove layers from geonode if they are no longer available on geoserver? A configuration option exists for this --remove-deleted

• Does geonode also update the geoserver config, to add a back-linkage to pycsw metadata url? Afaik, no.

import-layers

• Import metadata? Impression from https://github.com/GeoNode/geonode/blob/master/geonode/upload/utils.py is that no metadata is imported on file upload
• subfolders? yes this may be problematic if the folder has a tree if tif-tiles
• What filetypes are supported?
  .shp and .tif