do not use markdown to write documents, use sphinx, a powerful doc framework, and as I go through jekyll framework, I think we can still use it. but need to refactor code of website
Liubao (A) <bao....@huawei.com> 于2019年11月20日周三 下午5:11写道： > Documents are http://servicecomb.apache.org/ & > https://docs.servicecomb.io/java-chassis/en_US/index.html > related source repo: https://github.com/apache/servicecomb-website & > https://github.com/apache/servicecomb-docs > > -----邮件原件----- > 发件人: Shuo Chen [mailto:sureche...@gmail.com] > 发送时间: 2019年11月20日 15:43 > 收件人: dev@servicecomb.apache.org > 主题: Re: [DISCUSSION][Website] Optimization > > Can you list the documents we have had and need to write in the future？ > > Liubao (A) <bao....@huawei.com> 于2019年11月20日周三 下午3:41写道： > > > 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. > > > >> > > > > > > > > > >
