Published Pages for documentation?

[nathank (Nathan Kershaw)]

@stephtara

For me, the main advantage of the Page Publishing functionality is that it allows us to make public something that would otherwise have been private. But if, as will be the case for me, the documentation is already in a category that is going to be public, does it really make sense to also publish them?

Indeed! You just elucidated the chief use-case of page publishing (making private content public) - and its chief limitation (links confusion and lack of navigation). Just use your public category, and style it a bit if needed. You might find Discourse Doc Categories useful for navigation.