#5 build.sh and askbeta
Closed 4 years ago by ankursinha. Opened 4 years ago by alciregi.
alciregi/Ask-Fedora-SOP-docs master  into  master

file modified
+26 -15
@@ -1,35 +1,46 @@ 

  #!/bin/sh

  

- image="antora/antora"

+ image="docker.io/antora/antora"

  cmd="--html-url-extension-style=indexify site.yml"

  

  if [ "$(uname)" == "Darwin" ]; then

      # Running on macOS.

      # Let's assume that the user has the Docker CE installed

      # which doesn't require a root password.

-     docker run --rm -it -v $(pwd):/antora $image $cmd

+     echo ""

+     echo "This build script is using Docker container runtime to run the build in an isolated environment."

+     echo ""

+     docker run -e "ANTORA_DATE=$(date -u)" --rm -it -v $(pwd):/antora $image $cmd

  

  elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then

      # Running on Linux.

      # Check whether podman is available, else faill back to docker

      # which requires root.

+ 

      if [ -f /usr/bin/podman ]; then

-         runtime="podman"

-     else

-         runtime="docker"

-     fi

-     if groups | grep -wq "docker"; then

-         # Check if the current user is in the "docker" group. If true, no sudo is needed.

          echo ""

-         echo "This build script is using $runtime to run the build in an isolated environment."

+         echo "This build script is using Podman to run the build in an isolated environment."

          echo ""

-         $runtime run --rm -it -v $(pwd):/antora:z $image $cmd

-     else

-         # User isn't in the docker group; run the command with sudo.

+ 	podman run -e "ANTORA_DATE=$(date -u)" --rm -it -v $(pwd):/antora:z $image $cmd

+ 

+     elif [ -f /usr/bin/docker ]; then

+         echo ""

+         echo "This build script is using Docker to run the build in an isolated environment."

          echo ""

-         echo "This build script is using $runtime to run the build in an isolated environment. You might be asked for your password."

-         echo "You can avoid this by adding your user to the 'docker' group, but be aware of the security implications. See https://docs.docker.com/install/linux/linux-postinstall/."

+ 

+         if groups | grep -wq "docker"; then

+ 	    docker run -e "ANTORA_DATE=$(date -u)" --rm -it -v $(pwd):/antora:z $image $cmd

+ 	else

+             echo ""

+             echo "This build script is using $runtime to run the build in an isolated environment. You might be asked for your password."

+             echo "You can avoid this by adding your user to the 'docker' group, but be aware of the security implications. See https://docs.docker.com/install/linux/linux-postinstall/."

+             echo ""

+             sudo docker run -e "ANTORA_DATE=$(date -u)" --rm -it -v $(pwd):/antora:z $image $cmd

+ 	fi

+     else

          echo ""

-         sudo $runtime run --rm -it -v $(pwd):/antora:z $image $cmd

+ 	echo "Error: Container runtime haven't been found on your system. Fix it by:"

+ 	echo "$ sudo dnf install podman"

+ 	exit 1

      fi

  fi

file modified
+1
@@ -1,3 +1,4 @@ 

  * xref:staff.adoc[Staff]

  * xref:languages.adoc[Language support]

  * xref:categories.adoc[Categories]

+ * xref:spam.adoc[Handle spam]

@@ -5,12 +5,12 @@ 

  These are mostly of use to the administrators/moderators only.

  

  Ask Fedora is a https://discourse.org[Discourse] instance that is hosted by upstream.

- It currently resides at https://askbeta.fedoraproject.org and is invite only.

+ It currently resides at https://ask.fedoraproject.org and is invite only.

  It is currently in the process of being set up and is therefore not yet available to the public.

  

  Since it is hosted by upstream, Fedora does not need to supply any resources for the management of the infrastructure related to this hosting.

  

  == Reporting issues

  

- Issues/suggestions/feedback should ideally be reported on Ask Fedora using the https://askbeta.fedoraproject.org/c/site-feedback[Site Feedback] category.

+ Issues/suggestions/feedback should ideally be reported on Ask Fedora using the https://ask.fedoraproject.org/c/site-feedback[Site Feedback] category.

  Sensitive issues may be reported to the administrators directly via e-mail at ask-fedora-members@fedoraproject.org.

@@ -0,0 +1,24 @@ 

+ = Handling spam

+ 

+ AskFedora authentication is based on FAS. This should mitigate a lot spammers, spam bots and so on.

+ But we know: spam could happen everywhere.

+ 

+ == What we do

+ 

+ * If a post is **clearly spam**, we flag it as spam. In this way the post will be hidden.

+ * If the user that created the post is crearly a fake user (i.e. there are no other legit posts from this user) we suspend the user

+ 

+ * If a post looks like spam, but we have **doubts** about the post, we warn the user using a private message (PM)

+ ** If there are not answers or the user posts other spam content, we silence the user and we send a warn

+ *** Eventually: suspend the user

+ 

+ AskFedora users can help in keeping the forum a spam free place by flagging posts. In this way the moderators receive a report and can take action.

+ 

+ If we spot that a silenced or suspended user spams other fedora channels, then we will tell infra team in order to block the FAS account.

+ 

+ If the moderators and admins have doubts and they would like to discuss posts or actions to take, they can use the Staff category on AskFedora.

+ 

+ == Useful resources

+ 

+ * https://meta.discourse.org/t/discourse-moderation-guide/63116#heading--inappropriate-content

+ * https://meta.discourse.org/t/discourse-moderation-guide/63116#heading--difficult-user

@@ -1,7 +1,7 @@ 

  = Staff

  

  Discourse permits two levels of staff---Admins and Moderators.

- These are listed on Discourse https://askbeta.fedoraproject.org/about[here].

+ These are listed on Discourse https://ask.fedoraproject.org/about[here].

  

  The Administrators are able to modify any thing on the instance and therefore, this group should be kept as small as possible.

  For organisational purposes, this group is tracked by the https://admin.fedoraproject.org/accounts/group/view/ask-fedora[ask-fedora FAS group].

  1. Modified the build.sh script. This is now the same as the one used by fedora-docs

  2. Changed all the links still pointing to askbeta.f.o.

1 new commit added

  • Added a page: How to handle spam
4 years ago

Hrm, looks good, but it says there are conflicts. Can you rebase it please and I'll merge it?

Actually, I should be able to do that and merge. Working on it now.

Pull-Request has been closed by ankursinha

4 years ago