updating the HTTP metadata provider pages

[Tom Scavo]

On Mon, Apr 30, 2018 at 4:11 AM, Rod Widdowson <rdw at steadingsoftware.com> wrote:
>> In any case, I'm guessing you would rather preserve the history, right?
>
> I don't use history much.

Okay.

> If you really wanted to go the full distance you could have started with a tombstone pointing to the old page in case someone cares to chase backwards.

If I'm understanding you correctly, the current HTTPMetadataProviders
page provides that capability:
https://wiki.shibboleth.net/confluence/x/kQInAQ

In any case, the above page is fairly worthless as it stands, I admit.
I don't really see much practical use for it long term.

> But, to reemphasise that is a personal position.

Thanks for weighing in. I appreciate it.

Okay, here's what I'll do tomorrow unless someone objects in the meantime:

1. Revert the changes made on 4/28 (i.e., start from scratch)
2. Rename "HTTPMetadataProviders" to "FileBackedHTTPMetadataProvider"
3. Edit the incoming links

This preserves the history, which I think is the most valuable page
characteristic.

While I'm at it, I will rename "InlineMetadataProviderPlugin" to
"InlineMetadataProvider" for consistency with the other pages. In
other words, I will intentionally break two wiki links tomorrow.

Once the renaming is done, I plan to reconcile the "HTTP Client
Attributes" common to both "FileBackedHTTPMetadataProvider" and
"DynamicHTTPMetadataProvider." I see why those attributes are
duplicated across the HTTP metadata providers (because they have
different defaults) but the documentation is inconsistent at best.

Tom