diff --git a/apk/v3.15/main/dotnet-5.0/APKBUILD b/apk/v3.15/main/dotnet-5.0/APKBUILD
index c92ba72..0aa77db 100644
--- a/apk/v3.15/main/dotnet-5.0/APKBUILD
+++ b/apk/v3.15/main/dotnet-5.0/APKBUILD
@@ -76,12 +76,6 @@ source="
 "
 builddir="$srcdir/$pkgname"
 
-#
-# A custom version of snapshot is used because Darc expects the build directory
-# to be a git repo, thus the auto-generated tar.gz on github is not sufficient.
-# There's a way to trick Darc into thinking its in a git repo but it's hardly
-# elegant. Thus make sure to 'abuild snapshot' before 'abuild -r'
-#
 snapshot() {
 	mkdir -p "$srcdir"
 	cd "$srcdir"
diff --git a/apk/v3.15/main/dotnet-5.0/README.md b/apk/v3.15/main/dotnet-5.0/README.md
index 8b8aebf..22e9ad5 100644
--- a/apk/v3.15/main/dotnet-5.0/README.md
+++ b/apk/v3.15/main/dotnet-5.0/README.md
@@ -1,26 +1,39 @@
-
 # Description
 APKBUILD for dotnet 5.0.
+ 
+# How to build
+If built for the first time, make sure that _bootstrap=true, as build
+needs either Microsoft bootstrap or repo's bootstrap to build
+* abuild snapshot
+* abuild -r
+If you built with _bootstrap=true, push pkgrel by one and rebuild with
+_bootstrap=false as build with bootstrap creates packages that confuse
+dependencies between dotnet-3.1 and dotnet-5.0
 
 # Known issues
-The build itself has some odd kinks here and there that various patches
+* The build itself has some odd kinks here and there that various patches
 addresses. Please feel free to share any notes from your build environment.
+* A custom version of snapshot is used because Darc considers the build 
+directory as the top-most git  directory. Thus, an error occurs when one 
+attempts a build within aports (or other git repos). There's likely
+a way to adjust this, but for now this will do.
+
 
 # Patch notes
 
-* runtime_add-rid-for-alpine-315.patch/_
+## runtime_add-rid-for-alpine-315.patch/_
    As of version 5.0.12, runtime does not have the RIDs for Alpine Linux 3.15.
    This patch adds them. See dotnet/core issue #6985 
-* runtime_link-order.patch
+## runtime_link-order.patch
    For some reason, runtime does not link in the right order. This fixes that.
-* runtime_non-portable-distrorid-fix-alpine.patch
+## runtime_non-portable-distrorid-fix-alpine.patch
    Runtime adds the extra subversion in its calculation of Alpine's DistroRID
    when a non-portable build, but does so inconsistently. This creates an error
    when it generates its nuget package.
-* build_darc-fix-alpine.patch
+## build_darc-fix-alpine.patch
    Darc has a segmentation fault on Alpine due to not chosing the correct
    binary architecture. This patch deletes all the wrong ones so that it
    is forced to chose the correct one. See dotnet/source-build issue #1868.
-* sdk_telemetry-optout.patch
+## sdk_telemetry-optout.patch
    Optouts of telemetry gathering