How to help SE content find its way into our documentation

Question

How can we facilitate the flow of useful content from Stack Exchange into CiviCRM's documentation?

This conversation began in civicrm-docs#32.

Docs-worthy content

Examples:

• disabling households could get referenced in Organising your data > Contacts
• preventing users from adding contacts to ACL groups could get added to ACLs > Assign Users to Roles
• getting more than 25 results from the API could get mentioned with a "Note:" in the API Intro

I think in some cases a simple link to SE would be appropriate, and in others it might be better to copy-paste content.

Non-docs-worthy content

By contrast, here's some content that, although recent and popular, doesn't belong in docs:

• CiviCRM still creates MyISAM tables which results in Warning - because it's moot now that a bug has been fixed
• CiviCRM on Pantheon - because it's too specific

Personally, I think the majority of SE content is not worth migrating to our documentation. But for content that is, what can we do to shepherd it over to our docs?

Answer 1

Here's one idea that involves tracking content in SE with tags:

1. Begin using the following tags

   • add-to-docs-to-do for content that should get captured in documentation
   • add-to-docs-no for content that should not get captured
   • add-to-docs-done for that has already been captured

2. To help evaluate what content to add or skip

   1. Search for the following (79 results currently)

      is:question answers:1.. score:8.. -[add-to-docs-to-do] -[add-to-docs-no] -[add-to-docs-done]

   2. Tag question with add-to-docs-to-do or add-to-docs-no

   3. Once we get this queue down to 0, documentarians like me could add an RSS feed to spot questions automatically.

3. To help add content to docs

   1. Search for:

      [add-to-docs-to-do] -[add-to-docs-done]

   2. Add content to docs. (If it's already there, then consider trying to bring it to the surface a little more.)

   3. Tag question with add-to-docs-done

what does the SE community think of this idea? Would these tags present more clutter than they're worth?