docs softer language and link to discuss