Re: Document all outside-staff-priority values; neaten table (issue 280580043 by address@hidden)

[Carl Sorensen]

On 1/6/16 9:22 AM, "address@hidden" <address@hidden> wrote:

>
>At this time we have pushed this change as this is 'better than nothing'
>than waiting for someone who has the scripting skill needed to generate
>this 'automatic documentation' in the NR to update the table.
>
>This isn't the first time that we have taken the 'manual' approach in
>the NR for 'lists of things/functions/commands'. I have created manual
>tables for a few of the exhaustive lists in the NR Appendices. It is a
>maintenance headache but at least it can be maintained by those that
>cannot 'code'.
>
>I hope this is OK?

It is not my preference, but I don't get to make the rules.  If the
community is fine with it, it is better than nothing.

In my opinion, it is not better than nothing, because it helps users avoid
knowing the never-wrong method of finding the outside-staff-priority.  But
it is certainly easier for users, as long as the list is maintained.

I am less concerned about the manual tables in the NR for items that have
the exhaustive list in the NR appendices, because we can always easily
point the user to the exhaustive list.

I guess what this means is I need to figure out how to automatically
generate the exhaustive list and add it to the NR.  If I am concerned
enough about it, I'll do that.

Thanks,

Carl