Make proposals internal by default?

[krivit]

At the moment, their documentation is a part of the manual and the index displayed in HTML help. Since they are meant to operate "under the hood", we might want to change the template to give them an automatic keyword "internal" so that they are hidden. Any objections? @martinamorris , @chad-klumb , @CarterButts , @drh20drh20?

[drh20drh20]

I'm not sure what benefit there is to hiding them. If there's some small chance that the unhidden docs would be useful, as there seems to be, what's the harm in keeping the status quo?

[krivit]

The benefit is that they don't take up space in the index and in the manual, particularly since many of them are poorly documented.

We might even want to consider similarly hiding individual term and constraint documentation, since the user can still find them via the index and then look them up as needed.

[martinamorris]

I'm having a bit of trouble following this. Can you pls. remind me what the "manual" and the "index" are?

[krivit]

Index is what you get if you type library(help="ergm"). The manual is the PDF document with all the non-internal help entries; it gets generated during package build process and/or by R CMD Rd2pdf.

[krivit]

I increasingly think that all termalikes should be marked internal, since they make it hard to find anything in the package index, while being easily discoverable via the ergmTerm index.