OpenAM: 7 ± 2 core docs

OpenAM community logo To echo William of Ockham’s concern, I think I postulated too many entities.

Right now, the OpenAM core docs include 8 separate documents. That’s getting close to the 7 ± 2 limit (or should it be 4?), leaving little room if it turns out we want to expand.

The reference could probably fit in the back of the Admin Guide, despite the length of the generated log ref. Currently, everything in there pertains to administration rather than client or SDK development. The installation and policy agent installation guides could merge as well.

I’m tempted to make the changes before OpenAM 10, unless one of you has a good objection. Let me know if reducing the number of separate docs would be a mistake.

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s