This is a solid initiative Erick, very much appreciated. On Tue, 5 Apr 2022 at 18:37, Ekaterina Dimitrova <e.dimitr...@gmail.com> wrote:
> I like the idea, sometimes new users just don’t know where to start and > what/how/where to ask so this guidance sounds very helpful to me! Thank you > Bowen and Erick! > > On Tue, 5 Apr 2022 at 9:38, Erick Ramirez <erickramire...@apache.org> > wrote: > >> I was chatting to Bowen Song a couple of weeks ago and we stumbled on the >> topic of "low quality questions". They're the kind of questions that >> usually lack information and/or context that make them difficult to answer. >> As much as we hate it, we end up answering these questions with a bunch of >> other questions. >> >> Bowen and I talked about the idea of drafting a one-page document so >> there is some sort of a minimum standard (for lack of a better expression) >> when asking questions. The outcomes we are striving for are: >> >> - community is more inclined to respond >> - users hopefully get faster responses >> - users hopefully get better answers >> - the project has a higher community engagement from better user >> experiences >> >> For the record, the idea is NOT to be prescriptive and NOT to act as a >> hurdle to users. It is there to serve as a guide. >> >> The draft is available for review/feedback/comment here >> <https://docs.google.com/document/d/1-ZYpl9tif9OAMdAxFLxA1mTPNp0zkNW4kzXvfvRBHUc/edit?usp=sharing>. >> Here's the TL;DR -- >> >> - use a meaningful title or subject line >> - explain the problem you're trying to solve >> - provide background info + workarounds you've already tried >> - list software versions: C*, driver, Java, etc >> - provide full error message + full stack trace >> - provide configuration details >> - include table schema + full CQL query >> - include minimal code which reproduces the issue >> >> I'm proposing to publish the document as a sub-page of the Community >> <https://cassandra.apache.org/_/community.html> section of the website. >> I plan to send periodic notifications to the user ML and the ASF Slack >> channels to let users know of its existence. >> >> We're looking forward to your feedback. Cheers! >> >
