From b741b8820521f6e28421301749240a83d927d1eb Mon Sep 17 00:00:00 2001 From: Max Rydahl Andersen Date: Mon, 9 Sep 2024 09:52:56 +0200 Subject: [PATCH 1/2] notice about using generative AI for blogs --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index 5ab1568462..e963283249 100755 --- a/README.md +++ b/README.md @@ -70,6 +70,10 @@ If for some reason you need to deploy from your local machine, follow these inst ## Writing a blog +> **NOTE:** Using generative AI in *assisting* writing is fine, but please don't use it to write entire posts. +> Used badly generative AI's has a tendency to use complex works and phrasing making +the content hard to read and understand. Always review your blog with a human reader in mind, make sure it's factually correct and especially keep the human touch and opinions in the content. + To write a blog: - create an author entry in [_data/authors.yaml](https://github.com/quarkusio/quarkusio.github.io/blob/main/_data/authors.yaml) @@ -90,6 +94,8 @@ To write a blog: - Be aware that the `date` attribute in the asciidoc preamble defines when the article will be published. Add a `--future` flag when testing locally to ensure the article is included in the generated site. - send a pull request against the main branch and voilà + + ## Translations/Localization (l10n) The primary site (quarkus.io) is written in English. From 8f601e1286007c9145498de25d83fe0acc182600 Mon Sep 17 00:00:00 2001 From: Max Rydahl Andersen Date: Mon, 9 Sep 2024 12:27:59 +0200 Subject: [PATCH 2/2] Update README.md Co-authored-by: Holly Cummins --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index e963283249..75e8eaae17 100755 --- a/README.md +++ b/README.md @@ -71,7 +71,7 @@ If for some reason you need to deploy from your local machine, follow these inst ## Writing a blog > **NOTE:** Using generative AI in *assisting* writing is fine, but please don't use it to write entire posts. -> Used badly generative AI's has a tendency to use complex works and phrasing making +> Used badly, generative AI has a tendency to use complex words and phrasing. This makes the content hard to read and understand. Always review your blog with a human reader in mind, make sure it's factually correct and especially keep the human touch and opinions in the content. To write a blog: