I lead product development for a small software company, and we are in process of releasing our software for implementation by our partners. Part of the documentation we want to provide is real code examples of customizations that can be done as part of an implementation. I see three options for this:
- Formal documentation, possibly in wiki format
- A series of blog posts
- Self-answered Stack Overflow questions
The last option is appealing to me for a number of reasons:
- The Stack Exchange voting system allows us to know what examples are most useful
- Comments give us feedback as to when we need to enhance the examples
- The community can provide alternate answers/examples that might be better than our own!
- Developers looking for help or example code are more likely to find them on SOF
- We can still post blog articles or formal wiki documentation that link to SOF, perhaps with supplemental commentary?
I could see doing the same thing for programming-related support tickets we receive, should a question we receive be deemed helpful for others.
I want to be sure though that we are not abusing the platform. Is this within the spirit, intent, and rules of SOF?