Initial commit on hip_bugs markdown doc

Change-Id: I5a6915337b8664cfed9eaee9443c6e4406348574

docs/markdown/hip_bugs.md

@@ -0,0 +1,24 @@
+# HIP Bugs 
+
+<!-- toc -->
+
+- [Errors related to undefined reference to `__hcLaunchKernel__***__grid_launch_parm**](#error-undefined-reference)
+
+<!-- tocstop -->
+
+### Errors related to undefined reference to `__hcLaunchKernel__***__grid_launch_parm**
+
+Some common code practices may lead to hipcc generating a error with the form :
+undefined reference to `__hcLaunchKernel__ZN15vecAddNamespace6vecAddIidEEv16grid_launch_parmPT0_S3_S3_T_
+
+To workaround, try:
+- Avoid calling hcLaunchKernel from a function with the __host__ attribute
+__host__ MyFunc(…) {
+hipLaunchKernel(myKernel, …)
+- Avoid use of static with kernel definition:
+static __global__ MyKernel 
+- Avoid defining kernels in anonymous namespace
+namespace {
+__global__ MyKernel …
+- Avoid calling member functions 
+