The most concern is that Github wiki is adopted by little projects. The features of Github wiki are a little simple.
Saisai Shao <sai.sai.s...@gmail.com> 于2024年8月20日周二 15:39写道： > IMO, I'm inclined to use Github wiki for several reasons: > > 1. The document hub is mainly used to maintain and centralize some > development related things, like design doc, meeting minutes, we don't need > some fancy functionalities for Confluence. > 2. We already use Github to manage all the things, like issues, projects, > CIs, it would be better also putting the docs on the Github, so that it > will be easier for users to find out. On the contrary, Confluence is a > different place, we need to manage one more place besides Github. > > Thanks > Jerry > > > Xiaojing Fang <xiaoj...@datastrato.com> 于2024年8月19日周一 21:39写道： > > > +1 (binding) for GitHub wiki, Confluence offers more advanced features, > > while Wiki is simpler and integrates with GitHub. Since our primary goal > is > > to organize documents and our requirements are straightforward, I prefer > > using Wiki. > > > > > 2024年8月19日 20:30，roryqi <ror...@apache.org> 写道： > > > > > > After surveying on many Apache projects, only Superset uses Github > wiki. > > > Its wiki only shows simple information. > > > ASF Confluence is adopted by many projects. It seems more formal. > > > > > > +1 (non-binding) for ASF Confluence. > > > > > > Rory > > > > > > Minghuang Li <mcha...@apache.org> 于2024年8月19日周一 19:11写道： > > > > > >> Hi Jerry, > > >> > > >> Thank you for bringing this up. I fully support establishing a hub for > > >> developer and community > > >> documentation. > > >> > > >> ASF Confluence is preferable due to its richer features, despite > GitHub > > >> wiki's proximity to our > > >> codebase. > > >> > > >> I endorse moving forward with Confluence for better document > management. > > >> > > >> Best regards, > > >> Minghuang Li > > >> > > >> On 2024/08/19 10:15:18 Saisai Shao wrote: > > >>> Hi team, > > >>> > > >>> Currently, we have user-facing docs for users, but we're lacking > > >>> developer-facing docs for developers. By investigating other > projects, > > >> they > > >>> typically use Github wiki or ASF confluence for developer/community > > >> related > > >>> things. > > >>> > > >>> So here are two questions: > > >>> > > >>> 1. Shall we have a developer/community face document hub to manage > all > > >> the > > >>> docs? > > >>> 2. If so, what is your preference, Github wiki or ASF confluence? > > >>> > > >>> Best, > > >>> Jerry > > >>> > > >> > > > > >
