[x] Move the 3rd paragraph to be first, and change it to
This is IOOS's unofficial ERDDAP setup guide specifically geared to ERDDAP administrators who want to set up ERDDAP using Docker. For non-Docker installations and/or for the complete, official, ERDDAP setup guide, see https://coastwatch.pfeg.noaa.gov/erddap/download/setup.html
[x] For all of the next step pages, please add this as a second sentence to the Summary:
This is part of IOOS's unofficial ERDDAP setup guide specifically geared to ERDDAP administrators who want to set up ERDDAP using Docker. For non-Docker installations and/or for the complete, official, ERDDAP setup guide, see https://coastwatch.pfeg.noaa.gov/erddap/download/setup.html
[x] Your advice to "Reload ERDDAP-Docker container" is okay if you're on a PC, but bad advice for a public server (where full restarts are unnecessary and should be avoided because they lead to ERDDAP being unavailable).
[x] On "adding-datasets.html", "If a dataset fails to load, you can see logs under /erddap/data/logs." is misleading. Info is only written to the log file in chunks. So It's better to say
"If a dataset fails to load, visit http://localhost:8080/erddap/status.html (which flushes log information to the log file), then look for an error message related to the dataset in /erddap/data/logs/log.txt."
[x] On "adding-datasets.html", "ERDDAP caches datasets, so if you change one, you can force refresh by using the hardFlag system." is misleading. How about
"ERDDAP caches information about datasets, so if you change one, you can force a dataset to be fully reloaded by using the hardFlag system."
[x] The "Customize your ERDDAP" link points to modify-erddap.html which is entitled "Modifying ERDDAP". I like "customize", so I think the page should be called "Customize your ERDDAP" and customize-erddap.html.
[x] At the top of the customize page, please add to the summary
This is part of IOOS's unofficial ERDDAP setup guide specifically geared to ERDDAP administrators who want to set up ERDDAP using Docker. For non-Docker installations and/or for the complete, official, ERDDAP setup guide, see https://coastwatch.pfeg.noaa.gov/erddap/download/setup.html
Then you can the "Modifying ERDDAP" section can be:
Customizing ERDDAP
These are minimal instructions for customizing ERDDAP and are intended to get you up and running quickly so that you can test out ERDDAP.
[x] You don't explain the <ERDDAP_email.*> technical settings or general purpose. No one will figure it out from that. And the technical settings are consistent for NOAA email accounts:
I'm surprised those aren't the defaults for Docker installations.
[x] Similarly, the <ERDDAP_admin.*> settings purpose isn't explained. Also the recommended format for the adminPhone is
<adminPhone>+1 ###-###-####</adminPhone>
[x] Similarly, the <flagKeyKey> isn't explained. Explain it. It's important for security reasons.
[x] At the top of the update page, add to the Summary
This is part of IOOS's unofficial ERDDAP setup guide specifically geared to ERDDAP administrators who want to set up ERDDAP using Docker. For non-Docker installations and/or for the complete, official, ERDDAP setup guide, see https://coastwatch.pfeg.noaa.gov/erddap/download/setup.html
[x] On the update page,
change:
Check the log files at /erddap/data/logs/.
to:
"If there is a problem, visit http://localhost:8080/erddap/status.html (which flushes log information to the log file), then look for
an error message related to the dataset in /erddap/data/logs/log.txt."
[x] On the update page, there is "tags:" all by itself at the bottom. Flesh it out or remove it.
[x] On the utils page, please add to the Summary
This is part of IOOS's unofficial ERDDAP setup guide specifically geared to ERDDAP administrators who want to set up ERDDAP using Docker. For non-Docker installations and/or for the complete, official, ERDDAP setup guide, see https://coastwatch.pfeg.noaa.gov/erddap/download/setup.html
[x] On the utils page, please
change:
ERDDAP caches your datasets so changes may not show up. In that case you can refresh the dataset using the hardFlag with:
to
ERDDAP caches information about datasets so changes may not show up. In that case, you can fully refresh a dataset using a hardFlag with:
[x] On the utils page, there is "tags:" all by itself at the bottom. Flesh it out or remove it.
[x] Move the 3rd paragraph to be first, and change it to
[x] For all of the next step pages, please add this as a second sentence to the Summary:
[Or point to https://coastwatch.pfeg.noaa.gov/erddap/download/setupDatasetsXml.html for dataset setup.]
[x] Your advice to "Reload ERDDAP-Docker container" is okay if you're on a PC, but bad advice for a public server (where full restarts are unnecessary and should be avoided because they lead to ERDDAP being unavailable).
[x] On "adding-datasets.html", "If a dataset fails to load, you can see logs under /erddap/data/logs." is misleading. Info is only written to the log file in chunks. So It's better to say
[x] On "adding-datasets.html", "ERDDAP caches datasets, so if you change one, you can force refresh by using the hardFlag system." is misleading. How about
[x] The "Customize your ERDDAP" link points to modify-erddap.html which is entitled "Modifying ERDDAP". I like "customize", so I think the page should be called "Customize your ERDDAP" and customize-erddap.html.
[x] At the top of the customize page, please add to the summary
Then you can the "Modifying ERDDAP" section can be:
[x] You don't explain the <ERDDAP_email.*> technical settings or general purpose. No one will figure it out from that. And the technical settings are consistent for NOAA email accounts:
I'm surprised those aren't the defaults for Docker installations.
[x] Similarly, the
<ERDDAP_admin.*>
settings purpose isn't explained. Also the recommended format for the adminPhone is<adminPhone>+1 ###-###-####</adminPhone>
[x] Similarly, the
<flagKeyKey>
isn't explained. Explain it. It's important for security reasons.[x] At the top of the update page, add to the Summary
[x] On the update page, change:
to:
[x] On the update page, there is "tags:" all by itself at the bottom. Flesh it out or remove it.
[x] On the utils page, please add to the Summary This is part of IOOS's unofficial ERDDAP setup guide specifically geared to ERDDAP administrators who want to set up ERDDAP using Docker. For non-Docker installations and/or for the complete, official, ERDDAP setup guide, see https://coastwatch.pfeg.noaa.gov/erddap/download/setup.html
[x] On the utils page, please change:
to
[x] On the utils page, there is "tags:" all by itself at the bottom. Flesh it out or remove it.