I've seen https://stackoverflow.com/help/how-to-ask, which I suspect most people haven't. What I'm wondering is what is the best way to provide information about asking a question about a specific subject.
My example is someone asking a question about cognos, cognos-bi, cognos-11, or cognos-10. I believe a good Cognos question includes some or all of the elements below, based on the nature of the problem. (And the article may not be complete, so it should allow editing.)
Where would information like this be posted?
Asking a good Cognos question
There is already good information about asking a question on StackOverflow. This article supplements that with information specifically for Cognos users.
In order to attract experienced developers, you'll want to ask question that provide enough information, and don't expect the answerer to do all of the heavy lifting. When developing a question regarding IBM Cognos Analytics/Business Intelligence, consider the following items to include.
An example of the problem using the samples data (probably using the "GO sales (query)" package).
- Including screen captures, sample data, or sample code from your actual system could compromise data security.
- Other Cognos users probably have access to the samples data. They do not have access to your data.
- Using the samples can demonstrate a problem and prove it is a Cognos problem and not related to your data.
A report spec demonstrating the problem and the attempt to solve it (if the question is about how to code or configure a specific item in the Cognos UI)
- Report specs can be posted on https://pastebin.com/ so anyone interested in attempting to answer the question doesn't need to do the heavy lifting.
SQL: Sample data and query logic
- If you're using a reporting tool (like Cognos) to develop reports that access data in SQL Server, Oracle, or related database platforms, it seems reasonable to assume you have a basic knowledge of SQL and query logic. If you do not have basic SQL skills, there are many basic SQL tutorials available online.
- It is often simpler to express your query logic question in SQL terms rather than in Cognos terms. Even if you have trouble expressing your question this way, realize that it may be easier to express the answer this way, especially if you have not provided a report spec using the samples data.
- Sample data should be included as a link to a spreadsheet or SQL
CREATE TABLE
andINSERT
statements. - Sites like https://dbfiddle.uk/ provide a way to save, edit, and run SQL code. This can make communication and solution development easier.
[mre]
magic link. I'm having difficulties with suggesting pastebin or dbfiddle to post off-site code. Normally, we require everything to be in the question itself, i.e. one should be able to answer the question without having to access off-site links. Links may of course be provided as references or supportive material thoughcognos
wiki update (so, revised after this post), I actually say how important vocabulary is. As for off-site links, have you seen thesql
questions? If you're not using dbfiddle, you're doing it wrong. Not using dbfiddle puts a much bigger load on the answerer. Maybe someday StackOverflow will have that functionality built in.