[TriLUG] OT: Maintaining public/private versions of a document

[Mauricio Tavares via TriLUG]

On Fri, Jul 26, 2019 at 4:15 PM Brian via TriLUG <trilug at trilug.org> wrote:
>
> Hi Gang,
>
> I'm wondering if anyone has any tips on good software to use for
> maintaining a document in two forms, a "private" version that is
> complete, and a "public" version that excludes certain portions of the
> private version.  I'd love to be able to only modify the private
> version, somehow mark which sections are private, and have the public
> version stay in sync.  I'm not super-concerned with what format the
> source is in, but publishing to annotated PDF (that is, PDF including
> working intradocument links) would be a hard requirement.
>
> Offhand I bet this is something LaTeX could handle, but I don't know
> anything about actually using LaTeX, and would prefer a WYSIWYG editing
> experience.
>
> The particular use case is API documentation for a project I'm on.
> There're parts of the API we don't intend to publish to others, but
> would like to maintain documentation on the entire interface.
>
> Thoughts?  Suggestions?  FOSS is good but not a requirement.
>
      Poor man's approach: use a wiki like trac. You can have pages
that have fields that can only be included if you have rights to see
it. We used that to, for instance, only show code (extracted from our
internal repo) reviews to people in the programming group. Everyone
else would see program and code overview. We also would do that for
infrastructure stuff.

> Thanks!
> -Brian
> --
> This message was sent to: raubvogel at gmail.com <raubvogel at gmail.com>
> To unsubscribe, send a blank message to trilug-leave at trilug.org from that address.
> TriLUG mailing list : https://www.trilug.org/mailman/listinfo/trilug
> Unsubscribe or edit options on the web  : https://www.trilug.org/mailman/options/trilug/raubvogel%40gmail.com
> Welcome to TriLUG: https://trilug.org/welcome