juzhiyuan commented on a change in pull request #776: URL: https://github.com/apache/apisix-website/pull/776#discussion_r758876911
########## File path: website/docs/general/blog-contributing-guide.md ########## @@ -0,0 +1,353 @@ +--- +id: blog +title: Blog Contributing Guide +keywords: +- API gateway +- APISIX +- Apache APISIX +- blog guide +description: This article is a set of guidelines for contributors who want to write blogs. This guideline will teach you how to contribute if you want to add a new blog, or modify existing blog contents. +--- + +## Overview + +This guideline will teach you how to contribute if you want to add a new blog, or modify existing blog contents. + +If you find an issue on current documents, please feel free to [file an issue](https://github.com/apache/apisix-website/issues/new) and let the community know about it, or you can [sumbit a pull request](https://github.com/apache/apisix-website/pulls) to fix or update. Both actions are welcome and recommended. + +The blogs are written in two languages: English and Chinese. We encourage contributors to add blogs in their preferred language. It is completely up to you. We can handle translations and ask you to do a pull request review later. + +English blogs are located in the `website/blog` directory, in which they are categorized by year, month and date. For example, `website/blog/2021/11/22/develop-apisix-ingress-with-nocalhost-in-kubernetes.md` means that a blog named `develop-apisix-ingress-with-nocalhost-in-kubernetes.md` was published on November 22nd, 2021, and it is located in the `website/blog/2021/11/22 directory`. Review comment: Would better add the final URL after it's published 😄 ########## File path: website/docs/general/blog-contributing-guide.md ########## @@ -0,0 +1,353 @@ +--- +id: blog +title: Blog Contributing Guide +keywords: +- API gateway +- APISIX +- Apache APISIX +- blog guide Review comment: 😂 Blog guide? ########## File path: website/docs/general/blog-contributing-guide.md ########## @@ -0,0 +1,353 @@ +--- +id: blog +title: Blog Contributing Guide +keywords: +- API gateway +- APISIX +- Apache APISIX +- blog guide +description: This article is a set of guidelines for contributors who want to write blogs. This guideline will teach you how to contribute if you want to add a new blog, or modify existing blog contents. +--- + +## Overview + +This guideline will teach you how to contribute if you want to add a new blog, or modify existing blog contents. + +If you find an issue on current documents, please feel free to [file an issue](https://github.com/apache/apisix-website/issues/new) and let the community know about it, or you can [sumbit a pull request](https://github.com/apache/apisix-website/pulls) to fix or update. Both actions are welcome and recommended. + +The blogs are written in two languages: English and Chinese. We encourage contributors to add blogs in their preferred language. It is completely up to you. We can handle translations and ask you to do a pull request review later. + +English blogs are located in the `website/blog` directory, in which they are categorized by year, month and date. For example, `website/blog/2021/11/22/develop-apisix-ingress-with-nocalhost-in-kubernetes.md` means that a blog named `develop-apisix-ingress-with-nocalhost-in-kubernetes.md` was published on November 22nd, 2021, and it is located in the `website/blog/2021/11/22 directory`. + +Similarly, Chinese blogs are located in `website/i18n/zh/docusaurus-plugin-content-blog` directory and follow the same rules described above. + +## What you can contribute + +We encourge contributors and users to write blogs about Apache APISIX and publish them on the website. As long as blogs fit in the catogories listed below: Review comment: `As long as` is a little limitation IMHO, could we receive other kinds of blog contents? ########## File path: website/docs/general/blog-contributing-guide.md ########## @@ -0,0 +1,353 @@ +--- +id: blog +title: Blog Contributing Guide +keywords: +- API gateway +- APISIX +- Apache APISIX +- blog guide Review comment: How about using a keyword more like `how to write blog`? -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
