Hello Zhiguo Thanks for your comment, I have refined my example to check the ability of Docusaurus, especially about versioning. It’s simple and seemes easy to maintain with.
I think the most important point is the contents. Whether refreshing the Webpage/Document or not, Wiki’s information * contains some old informations * not linked to PR informations if the contributor refers to it. These are weak points of Bigtop, I think. I’d like to ask other members’ opinion, I acknowledge that wiki style is easiest way. (It might be better to create JIRA issue…) Regards, Leona Yoda From: 吴治国 <[email protected]> Date: Wednesday, August 3, 2022 19:36 To: [email protected] <[email protected]> Subject: Re: About Bigtop Website Thanks Leona, Personally, I prefer to use React too, and Docusaurus seems a great option. As far as I know, Docsy is based on Bootstrap4, which is unpopular recently, the only advantage of Docsy is(in my opinion), it's friendly with backend developer, React need us spend more time on it. But I'd like to vote React + Docusaurus. Best Regards, Zhiguo Wu > On Aug 3, 2022, at 17:35, [email protected] wrote: > > Hello Zhiguo, and Community members, > > These days I’m personally playing with arranging Bigtop documents. It’s not > yet perfect but I’m really interested in the discussion. > > https://urldefense.com/v3/__https://yoda-mon.github.io/bigtop-site-yoda-mon/__;!!GCTRfqYYOYGmgK_z!7F9pkOO0i3S5RhUxl0CLKgciSNUw_dVdupA0wAR8xkhqHbKVlibDKz9k-k8u9nucNZAaro469tA7sl8Zcak2e9A8-DM$<https://urldefense.com/v3/__https:/yoda-mon.github.io/bigtop-site-yoda-mon/__;!!GCTRfqYYOYGmgK_z!7F9pkOO0i3S5RhUxl0CLKgciSNUw_dVdupA0wAR8xkhqHbKVlibDKz9k-k8u9nucNZAaro469tA7sl8Zcak2e9A8-DM$> > https://urldefense.com/v3/__https://github.com/yoda-mon/bigtop-site-yoda-mon__;!!GCTRfqYYOYGmgK_z!7F9pkOO0i3S5RhUxl0CLKgciSNUw_dVdupA0wAR8xkhqHbKVlibDKz9k-k8u9nucNZAaro469tA7sl8Zcak2uOn2dBM$<https://urldefense.com/v3/__https:/github.com/yoda-mon/bigtop-site-yoda-mon__;!!GCTRfqYYOYGmgK_z!7F9pkOO0i3S5RhUxl0CLKgciSNUw_dVdupA0wAR8xkhqHbKVlibDKz9k-k8u9nucNZAaro469tA7sl8Zcak2uOn2dBM$> > > I use Docusaurus > (https://urldefense.com/v3/__https://docusaurus.io/__;!!GCTRfqYYOYGmgK_z!7F9pkOO0i3S5RhUxl0CLKgciSNUw_dVdupA0wAR8xkhqHbKVlibDKz9k-k8u9nucNZAaro469tA7sl8Zcak2MBR5Ng4$ > ), it could be another generator candidate. > (Apache Superset uses this generator) > > Compared with Hugo > Pros: > > * It made by React, most popular JS library these days. As my sample, we > can easily create a grid with for-statement with JSX. > * Build-in versioning, Drop-down menu, i11n, or other features. (I think > we have to chose appropriate design in Hugo. Doccy seems ok while Ananke > seems not) > Cons: > > * It relatively new project so could be unstable. > > > Anyway, as a contributor I feel that we need versioned documentation to put a > things in order. > > Regards, > > Leona Yoda > > > > From: 吴治国 <[email protected]> > Date: Tuesday, August 2, 2022 21:19 > To: [email protected] <[email protected]> > Subject: About Bigtop Website > Hi community, > > While waiting for the conclusion about ClickHouse, I'd like to continue > Olaf's work on Bigtop website[1]. > > The website I developed keeps his choice of framework, Hugo[2] with the theme > Docsy[3], which is currently hosted on > https://urldefense.com/v3/__http://test.ydctml.top/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNoRrJjao$<https://urldefense.com/v3/__http:/test.ydctml.top/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNoRrJjao$><https://urldefense.com/v3/__http:/test.ydctml.top/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNoRrJjao$%3chttps:/urldefense.com/v3/__http:/test.ydctml.top/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNoRrJjao$%3e> > , and the repository is under > https://urldefense.com/v3/__https://github.com/kevinw66/bigtop-website__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNEXi4dw0$<https://urldefense.com/v3/__https:/github.com/kevinw66/bigtop-website__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNEXi4dw0$><https://urldefense.com/v3/__https:/github.com/kevinw66/bigtop-website__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNEXi4dw0$%3chttps:/urldefense.com/v3/__https:/github.com/kevinw66/bigtop-website__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNEXi4dw0$%3e> > . > > But this cannot be done by myself, especially the documents, I need your help > with this. > > We can improve it continuously, when it's ready, I think we can create a repo > called bigtop-website under Apache Foundation. > > Can you please tell me your opinion? Thanks. > > Best Regards, > Zhiguo Wu > > [1]: > https://urldefense.com/v3/__https://lists.apache.org/thread/zg0569qnryb8dp450pom53c3ypkd3n7p__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNNK0lEZU$<https://urldefense.com/v3/__https:/lists.apache.org/thread/zg0569qnryb8dp450pom53c3ypkd3n7p__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNNK0lEZU$><https://urldefense.com/v3/__https:/lists.apache.org/thread/zg0569qnryb8dp450pom53c3ypkd3n7p__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNNK0lEZU$%3chttps:/urldefense.com/v3/__https:/lists.apache.org/thread/zg0569qnryb8dp450pom53c3ypkd3n7p__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXNNK0lEZU$%3e> > [2]: > https://urldefense.com/v3/__https://gohugo.io/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXN7i4xYmo$<https://urldefense.com/v3/__https:/gohugo.io/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXN7i4xYmo$><https://urldefense.com/v3/__https:/gohugo.io/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXN7i4xYmo$%3chttps:/urldefense.com/v3/__https:/gohugo.io/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXN7i4xYmo$%3e> > [3]: > https://urldefense.com/v3/__https://www.docsy.dev/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXN5sbf1DU$<https://urldefense.com/v3/__https:/www.docsy.dev/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXN5sbf1DU$><https://urldefense.com/v3/__https:/www.docsy.dev/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXN5sbf1DU$%3chttps:/urldefense.com/v3/__https:/www.docsy.dev/__;!!GCTRfqYYOYGmgK_z!4FQ3IGTnMfQE3anVHq86jm89fybGhYFc6vm8a9et9rJzA_djWqnq80QXy1bWb9D6g5YnC9P09Dyjofrs9DXN5sbf1DU$%3e>
