How about using gitbook? Because markdown is easier to edit(the user manual using markdown and gitbook) . I find official website using Jekyll is quite difficult to update the contents, although the website is more beautiful than gitbook.
-----邮件原件----- 发件人: victor chan [mailto:victorchan...@gmail.com] 发送时间: 2019年11月20日 15:33 收件人: yhs0092 <dev@servicecomb.apache.org> 主题: Re: [DISCUSSION][Website] Optimization Tools to transform your plain text into static websites, like jekyll, sphinx, etc. sen sun <asd992825...@gmail.com> 于2019年11月20日周三 下午3:31写道： > What is "documentation framework"? > > sen sun <asd992825...@gmail.com> 于2019年11月20日周三 下午3:26写道： > > > Agree with your suggestion. > > The official website has not been updated for a long time. It’s time > > to > do > > it. > > > > victor chan <victorchan...@gmail.com> 于2019年11月20日周三 下午3:17写道： > > > >> I am doing website optimization, I have some ideas, I look forward > >> to > your > >> suggestions. > >> 1. I think we need to bring together the documents for our projects. > >> 2. We need to merge the "user manual" and the "getting started". > >> Now, > they > >> are displayed separately on the website, which will make the user > >> read discontinuous. > >> 3. We need to use the same documentation framework in each project > >> so > that > >> they can be easily integrated into the website. > >> > > >
