I found some good references to leverage Jekyll and Markdown for both website and documentation. All content will go with HTML finally.
Let's try Jekyll/Markdown first. Thanks. 2015-01-14 20:07 GMT+08:00 Li Yang <[email protected]>: > The only problem with MD in git is how to offline preview. > > I googled and found > http://stackoverflow.com/questions/9843609/view-md-file-offline > > Let's experiment with some tools and decide if wiki is necessary. > > On Tue, Jan 6, 2015 at 10:50 PM, Luke Han <[email protected]> wrote: > > > How about confluence's cloud service? they are offering free plan for > open > > source project? > > > > Is there any apache project using their service now? > > > > > > > > 2015-01-06 4:04 GMT+08:00 Henry Saputra <[email protected]>: > > > > > +1 for using MD files for docs and we could use dev@ list to propose > > > changes or design. > > > > > > As Ted mentioned before, the ASF wiki is super slow. > > > > > > - Henry > > > > > > On Mon, Jan 5, 2015 at 6:01 AM, Luke Han <[email protected]> wrote: > > > > then, I think we will leverage markdown and git for documentation. > > Since > > > we > > > > have gh-pages for website, we will adjust structure to enable docs > > > > available there. > > > > > > > > Thanks. > > > > > > > > > > > > 2015-01-05 5:49 GMT+08:00 Ted Dunning <[email protected]>: > > > > > > > >> How much of this needs to be wiki and how much could be done as web > > > pages? > > > >> > > > >> The issue is that the wikis available from Apache are dead slow and > > are > > > >> often closed to outsiders due to spamming. > > > >> > > > >> > > > >> On Sun, Jan 4, 2015 at 6:58 AM, Luke Han <[email protected]> > wrote: > > > >> > > > >> > Dear Mentors, > > > >> > Could we apply wiki for Kylin? There are many documents we > want > > to > > > >> > migrated to there and add more also. > > > >> > Thanks. > > > >> > > > > >> > Luke > > > >> > > > > >> > > > > > > -- Best Regards! --------------------- Luke Han
