Thanks for this, it's a great help. Maybe we should organize the Q&A by specific OS type. "brew" is obviously an OS X only command so it should be clear to a user what applies to him/her.
In addition to Ruilong's example of Apache. I think Postgres' developer FAQ is also very useful https://wiki.postgresql.org/wiki/Developer_FAQ On Tue, Jun 28, 2016 at 12:13 AM, Lili Ma <[email protected]> wrote: > @Ming, Great job! > > I think we can rename the "Q&A Collections" to "Q&A" or "FAQ". > > Also we can add some index for the questions on this page, and adjust the > format. > https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=65144284 > > > > > On Tue, Jun 28, 2016 at 2:09 PM, Ruilong Huo <[email protected]> wrote: > > > Agree with Hubert. It would be great to add an index page such as TOC > which > > linking to details of different sections. > > Here is an example from Apache itself: > > http://www.apache.org/foundation/faq.html > > > > Best regards, > > Ruilong Huo > > > > On Tue, Jun 28, 2016 at 2:04 PM, Hubert Zhang <[email protected]> wrote: > > > > > Good Jobs! Ming > > > I suggest to divide the developer FAQ and user FAQ into two independent > > > pages or add an index at the begining of the FAQ page. > > > > > > Thanks. > > > > > > On Tue, Jun 28, 2016 at 12:35 PM, Ming Li <[email protected]> wrote: > > > > > > > Good idea. > > > > > > > > (1) Added one FAQ page here: > > > > > > > > > > https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=65144284 > > > > (2) This link with other common used links also added to README.md ( > > > > > > > > > > > > > > https://github.com/apache/incubator-hawq/commit/5a8622707749cfe98c61188ab212a61c83778998 > > > > ) > > > > > > > > So let's continue to add FAQ in that page or move previous. ~..~ > > > > > > > > > > > > On Fri, Jun 24, 2016 at 5:31 PM, Guo Gang <[email protected]> wrote: > > > > > > > > > I agree that we need a separate FAQ page on apache. Several other > > > > > suggestions: > > > > > > > > > > 1) Add the FAQ info and url to readme.md to educate users to > search > > > FAQ > > > > > before asking. > > > > > 2) Announce it on user mail list when it is done. > > > > > 3) Move some previous installation related FAQ to the new FAQ page. > > > > > > > > > > 2016-06-24 17:01 GMT+08:00 Lili Ma <[email protected]>: > > > > > > > > > > > Thumbs-up! > > > > > > > > > > > > We can put some common questions and answers on the wiki page, so > > > that > > > > > > users can easily find solutions for their problem. > > > > > > > > > > > > > https://cwiki.apache.org/confluence/display/HAWQ/Apache+HAWQ+Home > > > > > > > > > > > > This page already exist some useful informations, including HAWQ > > > > > > introduction, Build HAWQ, contributing to HAWQ, HAWQ RoadMap, > etc. > > I > > > > > think > > > > > > we can add one sub-page named FAQ for it. > > > > > > > > > > > > What do you think? > > > > > > > > > > > > > > > > > > Thanks > > > > > > Lili > > > > > > > > > > > > On Fri, Jun 24, 2016 at 3:35 PM, Greg Chase <[email protected]> > > > wrote: > > > > > > > > > > > > > The Wiki should serve that function. An FAQ might be a page or > it > > > > might > > > > > > be > > > > > > > the structure. > > > > > > > > > > > > > > The Wiki is more accessible than the Github for this. > > > > > > > > > > > > > > This email encrypted by tiny buttons & fat thumbs, beta voice > > > > > > recognition, > > > > > > > and autocorrect on my iPhone. > > > > > > > > > > > > > > > On Jun 24, 2016, at 12:21 AM, hong wu <[email protected] > > > > > > wrote: > > > > > > > > > > > > > > > > Great point ! We really need this place to find everything > out. > > > > > > > > > > > > > > > > BTW, should this kind of wiki or document belongs to the HAWQ > > > repo > > > > > > which > > > > > > > > could record every change with git commits, not just a link. > I > > > > think > > > > > > the > > > > > > > > benefit is to sync with code changes timely. > > > > > > > > > > > > > > > > Best > > > > > > > > xunzhang > > > > > > > > > > > > > > > > 2016-06-24 14:56 GMT+08:00 Ming Li <[email protected]>: > > > > > > > > > > > > > > > >> Hi all, > > > > > > > >> > > > > > > > >> We have many sources about hawq discussions ( jira /mail > list/ > > > > > > > >> stackoverflow), however for many questions, if we have > > definite > > > > > > > solution, I > > > > > > > >> would like we can offer an official answer, and it is better > > to > > > > > > > maintain in > > > > > > > >> one place, so that we can maintain and search them quickly. > > > > > > > >> > > > > > > > >> So I suggest to create one wiki page for it, so that > everyone > > > can > > > > > > > summary > > > > > > > >> any FAQ by hands, and put them on that. > > > > > > > >> > > > > > > > >> Any opinions/suggestions is welcomed. Thanks. > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > Thanks > > > > > > Hubert Zhang > > > > > >
