diff --git a/graphs/.$Blog Maintainers.drawio.bkp b/graphs/.$Blog Maintainers.drawio.bkp index 17a3aa2..8615490 100644 --- a/graphs/.$Blog Maintainers.drawio.bkp +++ b/graphs/.$Blog Maintainers.drawio.bkp @@ -1,335 +1,9 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -661,11 +335,417 @@ - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/graphs/.$maintainers_opsec_blog_only.drawio.bkp b/graphs/.$maintainers_opsec_blog_only.drawio.bkp new file mode 100644 index 0000000..9e7c10c --- /dev/null +++ b/graphs/.$maintainers_opsec_blog_only.drawio.bkp @@ -0,0 +1,376 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/graphs/Blog Maintainers.drawio b/graphs/Blog Maintainers.drawio index fac8b5f..0165238 100644 --- a/graphs/Blog Maintainers.drawio +++ b/graphs/Blog Maintainers.drawio @@ -1,335 +1,9 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -661,11 +335,417 @@ - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/graphs/maintainers_opsec_blog_only.drawio b/graphs/maintainers_opsec_blog_only.drawio new file mode 100644 index 0000000..9e7c10c --- /dev/null +++ b/graphs/maintainers_opsec_blog_only.drawio @@ -0,0 +1,376 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/opsec/contribute/63.png b/opsec/contribute/63.png new file mode 100644 index 0000000..d7cd626 Binary files /dev/null and b/opsec/contribute/63.png differ diff --git a/opsec/contribute/index.html b/opsec/contribute/index.html index 922f46d..48a004c 100644 --- a/opsec/contribute/index.html +++ b/opsec/contribute/index.html @@ -121,8 +121,10 @@ To be showcased:

How to contribute new tutorials

-

Now you first need to sign up on gitea, just ping me directly on SimpleX so that i create your account manually.

+ +

From here you'll also get to join the Contributors private chatroom where we brainstorm new contributions, formulate todolists, assign those todolists to contributors like you, and review those contributions:

+
- -
-
-
-
-

The Quality Standard

-

In order to make sure the content isn't rushed and the quality of the blog overall remains high, we have the following quality standard:

- -

Rather than writing a gigantic wall of text and loose you halfway, as you can see i made a graph. This is the most effective way of conveying your ideas to your audience, so don't hesitate to make graphs using drawio (with colors preferably) instead of writing walls of text that nobody will read.

- -

First of all, the general structure of the content is with the Why / What / How methodology This following the minimalistic style where everything that is used and mentionned must be justified. (Everything that has no justification to be there, is to simply be removed.)

-
    -
  1. Why should I care ?

  2. -
  3. What are my options ?

  4. -
  5. How can i implement it ?

  6. -
- -

Nobody cares about your message until you tell them why they should care. Usually that goes by telling them a short story that they can relate to, in our case it's an opsec scenario that explains what an adversary can do against you.

-

The blog is structured around 3 core scenarios:

-
    -
  1. Privacy: The adversary can see you do something, how can you prevent it ?

  2. -
  3. Anonymity: The adversary knows that it's you who did it, how can you prevent it ?

  4. -
  5. Deniability: The adversary busts down your door, and forces you to open your devices, how can you make sure he doesn't find anything in there ?

  6. -
-

If the scenario of your contribution doesn't fit into (or serve a purpose for) one of those 3, it's most likely off-topic.

-

-Context: In your house, in your bedroom, if there are windows to look outside
-Situation: the annoying neighbor always stops by to look at what you're doing in your bedroom
-Are you ok with this situation ?
-
-
-

So you told your story to highlight the problem, the reader understands that they want privacy. Now you need to tell them the what, what are their options ?

-

-You have a few options to prevent your annoying neighbor from seeing what you're doing in your bedroom:
-1) get rid of all windows and have a house with only walls : expensive
-2) install curtains on your windows : inexpensive
-
-
-

Sidenote: Nobody wants to read a wall of text. HIGHLIGHT the important parts (using the <b></b> tags of your text so that the reader's eye is immediately drawn to what matters most.

-

Now that you laid out the Why, you of course tell them what the best option is, and then you're going to tell them how they can implement it.

-

-Let's showcase how to install curtains, as it's the easiest and cheapest solution to prevent outsiders from seeing what you're doing in your bedroom.
-
-1) buy it, 
-2) then you attach it above your windows, using screws and screwing it into the wall, (warning, if you're living in an apartment, ask for your landlord's permission!)
-3) then you can move the curtain to prevent outsiders from peeking in
-
-
-

But the thing is, we're not lazy blogwriters here, talking about the path is not enough, you are expected to show the readers how you walk that path. This is why the todolists for new blogposts are structured like so:

-

-to be explained: (WHY + WHAT)
--
--
--
-
-to be showcased: (HOW)
--
--
--
--
-
-
-

In the first part usually there is the to be explained section, where you tell the user why they should care, and what their options are, but afterward there usually is the "to be showcased" part. In that part, you are expected to do a step-by-step tutorial of how to implement the solution which means that you are literally implementing the solution yourself, for yourself, but showing everyone how you're doing it.

-

Let's take a small todolist that is as follows:

-

-to be showcased:
-1)Download grapheneOS (GUI digital step)
-2)Reboot the phone (Physical step)
-3)flash graphene OS on the phone (CLI digital step)
-
-
- -

Here we have a combination of the 3 possible types of steps you may be expected to showcase, a physical step, a GUI digital step, and a CLI digital step.

-

The first step being a GUI digital step, you need to take a screenshot with arrows, to make it simple i recommend using flameshot like i explained above, to have screenshots like that:

- -

In the case of the physical step, you need to take a picture, and add arrows in it if needed, like so:

- -

While editing the html file it will look like that (as you need to put the picture in the same folder as the tutorial you're editing):

-

-<img src="1.png">
-
-
-

If you want to reuse an image from another tutorial like i just did above (it's totally fine), but rather than copying the image from another tutorial and waste diskspace, you can simply reuse the image of another tutorial by adding ../tutorialfolder/ before the path of the image like so:

-

-<img src="../graphene/10.png">
-
-
-

and lastly if you have a CLI step to show, you need to simply copy paste the terminal output in the pre code blocks while still highlighting what's important like so:

-


-<pre><code class="nim">
-
-nowhere# ./flash-all.sh
-Warning: skip copying bootloader_a image avb footer (bootloader_a partition size: 0, bootloader_a image size: 14125140).
-Sending 'bootloader_a' (13794 KB)                  OKAY [  0.364s]
-Writing 'bootloader_a'                             (bootloader) Flashing pack version slider-14.5-11677881
-(bootloader) flashing platform gs101
-(bootloader) Validating partition ufs
-(bootloader) Validating partition partition:0
-
-[...]
-
-OKAY [  3.089s]
-Finished. Total time: 3.454s
-Setting current slot to 'a'                        OKAY [  0.058s]
-Finished. Total time: 0.059s
-Rebooting into bootloader                          OKAY [  0.000s]
-
-[...]
-
-Sending sparse 'super' 11/13 (254972 KB)           OKAY [  6.618s]
-Writing 'super'                                    OKAY [  0.950s]
-Sending sparse 'super' 12/13 (254972 KB)           OKAY [  6.621s]
-Writing 'super'                                    OKAY [  0.935s]
-Sending sparse 'super' 13/13 (46284 KB)            OKAY [  1.216s]
-Writing 'super'                                    OKAY [  0.204s]
-Erasing 'userdata'                                 OKAY [  0.390s]
-Erase successful, but not automatically formatting.
-File system type raw not supported.
-wipe task partition not found: cache
-Erasing 'metadata'                                 OKAY [  0.007s]
-Erase successful, but not automatically formatting.
-File system type raw not supported.
-Finished. Total time: 105.929s
-Rebooting into bootloader                          OKAY [  0.000s]
-Finished. Total time: 0.150s
-nowhere#
-
-</pre></code>
-
-

If there are parts of the commandline output that don't matter, just replace them with [...] in order to stick to what the user needs to see.

- -

And lastly, if you are someone that makes alot of spelling and grammar mistakes (like me, i know i'm guilty of that aswell), use LTEX+'s addon on vscodium (which is the FOSS version of vscode), it will setup a local LLM that will find your grammar and spelling mistakes:

-

-wget -qO - https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg \
-    | gpg --dearmor \
-    | sudo dd of=/usr/share/keyrings/vscodium-archive-keyring.gpg
-
-echo 'deb [ signed-by=/usr/share/keyrings/vscodium-archive-keyring.gpg ] https://download.vscodium.com/debs vscodium main' \
-    | sudo tee /etc/apt/sources.list.d/vscodium.list
-
-sudo apt update && sudo apt install codium
-
-
- - - - - - - - - - -

Now using this addon you can find your typos more easily (as it highlights them for you), effectively helping you find and fix them, so if english isn't your first language definitely make sure that you run LTEX+ once after you finished writing your article, so that you don't leave spelling mistakes behind.

- - -

DISCLAIMER: a blogpost is NOT complete until it follows this quality standard, if you find one that doesn't meet those requirements, do mention it on their gitea issue or ping me directly about it on SimpleX.

-

Same thing if you want to contribute a blogpost that does not meet these quality requirements, i do not care, it is NOT finished until it meets those requirements. Do not be suprised if i refuse your blog contribution for weeks on end if it doesn't meet the requirements. It may take a little more time to do things properly, but at least you're not lowering the quality of the overall blog by following it.

- -
-
-
-
diff --git a/opsec/index.html b/opsec/index.html index 01e58e0..f09b79b 100644 --- a/opsec/index.html +++ b/opsec/index.html @@ -40,7 +40,7 @@
Previous Page

Operational Security: Privacy, Anonymity and Deniability

Tutorials to show how to achieve Privacy, Anonymity and Deniability online. - I have a quality standard as to how i do these tutorials, if there are any improvements i can do on them please let me know.

+ I have a quality standard as to how i do these tutorials, if there are any improvements i can do on them please let me know.

SHOWCASED ARTICLE: Learn how to audit your own setup, to determine your Operational Security (OPSEC) Level, and find out what is the most appropriate internet use for it.

@@ -404,8 +404,9 @@
  1. ❌ How to become a Moderator
  2. ✅ How to become a Contributor
  3. +
  4. ✅ The Quality Standard
  5. ❌ How to become a Maintainer
  6. -
  7. ❌ Hpw to become an Administrator
  8. +
  9. ❌ How to become an Administrator
  10. ✅ How to run the blog yourself

diff --git a/opsec/logos/opsec.png b/opsec/logos/opsec.png new file mode 100644 index 0000000..902536e Binary files /dev/null and b/opsec/logos/opsec.png differ diff --git a/opsec/maintainers/0.5.png b/opsec/maintainers/0.5.png new file mode 100644 index 0000000..b76176a Binary files /dev/null and b/opsec/maintainers/0.5.png differ diff --git a/opsec/maintainers/0.png b/opsec/maintainers/0.png new file mode 100644 index 0000000..f0f38e8 Binary files /dev/null and b/opsec/maintainers/0.png differ diff --git a/opsec/maintainers/1.png b/opsec/maintainers/1.png new file mode 100644 index 0000000..f7995b0 Binary files /dev/null and b/opsec/maintainers/1.png differ diff --git a/opsec/maintainers/2.png b/opsec/maintainers/2.png new file mode 100644 index 0000000..85e18c2 Binary files /dev/null and b/opsec/maintainers/2.png differ diff --git a/opsec/maintainers/3.png b/opsec/maintainers/3.png new file mode 100644 index 0000000..f3e7612 Binary files /dev/null and b/opsec/maintainers/3.png differ diff --git a/opsec/maintainers/4.png b/opsec/maintainers/4.png new file mode 100644 index 0000000..5daf1fd Binary files /dev/null and b/opsec/maintainers/4.png differ diff --git a/opsec/maintainers/5.png b/opsec/maintainers/5.png new file mode 100644 index 0000000..1ef27d1 Binary files /dev/null and b/opsec/maintainers/5.png differ diff --git a/opsec/maintainers/6.png b/opsec/maintainers/6.png new file mode 100644 index 0000000..8b4a9ff Binary files /dev/null and b/opsec/maintainers/6.png differ diff --git a/opsec/maintainers/index.html b/opsec/maintainers/index.html index df5942a..6cad73d 100644 --- a/opsec/maintainers/index.html +++ b/opsec/maintainers/index.html @@ -8,7 +8,7 @@ - maintainers Setup + How to become a Maintainer @@ -60,10 +60,10 @@
- Previous Page

nihilist@Mainpc-PrivateVM-Debian12 - 2025-03-17

-

maintainers Setup

+ Previous Page

nihilist@Mainpc-PrivateVM-Debian12 - 2025-03-21

+

How to become a Maintainer

-

+

Becoming a Maintainer is the next step to contribute to the Opsec blog and Darknet Lantern projects, where you get to assist the other contributors contribute just like you did.

@@ -75,7 +75,54 @@
-

Initial Setup

+

Onboarding new Contributors

+

First of all if there are new contributors that want to join in and contributors, maintainers need to invite them to the contributors chatroom, (and if said maintainer is an administrator, give them their git account credentials):

+ +

Once added in private messages, the user can be invited (and can safely get their new git account credentials) :

+ +

In the Contributors chatroom, the contributors will be able to communicate with maintainers directly:

+ +

For example, to brainstorm and adjust todolists:

+ + +
+
+
+
+ + +
+
+
+
+

Assigning contributors onto todolists

+

Or to assign people to work on todolists:

+ +

As a maintainer, you get to have authority on what todolists get to contain, you can validate them or edit them however you wish. In fact as it takes time to convert valid criticism into todolist, there is also incentive to write them as a maintainer (at the end of each month you'll get rewarded 2 euros per todolist that you correctly write)

+ +

(don't forget to move the issue into the "assigned" column on the project board aswell:

+ + +
+
+
+
+ + +
+
+
+
+

Reviewing Contributions

+

And lastly, the maintainer's role is to review contributions whenever a contributor submits one.

+

As you are most likely already aware since you are supposed to already be a contributor, whenever someone submits a contribution, they need to follow the quality standard.

+

+

+

+

+

+

+


@@ -102,7 +149,7 @@
 	    
-

Setup



+

How to become a m




diff --git a/opsec/contribute/50.png b/opsec/qualitystandard/50.png
similarity index 100%
rename from opsec/contribute/50.png
rename to opsec/qualitystandard/50.png
diff --git a/opsec/contribute/51.png b/opsec/qualitystandard/51.png
similarity index 100%
rename from opsec/contribute/51.png
rename to opsec/qualitystandard/51.png
diff --git a/opsec/contribute/52.png b/opsec/qualitystandard/52.png
similarity index 100%
rename from opsec/contribute/52.png
rename to opsec/qualitystandard/52.png
diff --git a/opsec/contribute/53.png b/opsec/qualitystandard/53.png
similarity index 100%
rename from opsec/contribute/53.png
rename to opsec/qualitystandard/53.png
diff --git a/opsec/contribute/54.png b/opsec/qualitystandard/54.png
similarity index 100%
rename from opsec/contribute/54.png
rename to opsec/qualitystandard/54.png
diff --git a/opsec/contribute/55.png b/opsec/qualitystandard/55.png
similarity index 100%
rename from opsec/contribute/55.png
rename to opsec/qualitystandard/55.png
diff --git a/opsec/contribute/56.png b/opsec/qualitystandard/56.png
similarity index 100%
rename from opsec/contribute/56.png
rename to opsec/qualitystandard/56.png
diff --git a/opsec/contribute/57.png b/opsec/qualitystandard/57.png
similarity index 100%
rename from opsec/contribute/57.png
rename to opsec/qualitystandard/57.png
diff --git a/opsec/qualitystandard/58.png b/opsec/qualitystandard/58.png
new file mode 100644
index 0000000..185dd4d
Binary files /dev/null and b/opsec/qualitystandard/58.png differ
diff --git a/opsec/qualitystandard/59.png b/opsec/qualitystandard/59.png
new file mode 100644
index 0000000..6841474
Binary files /dev/null and b/opsec/qualitystandard/59.png differ
diff --git a/opsec/qualitystandard/60.png b/opsec/qualitystandard/60.png
new file mode 100644
index 0000000..e16a43f
Binary files /dev/null and b/opsec/qualitystandard/60.png differ
diff --git a/opsec/qualitystandard/61.png b/opsec/qualitystandard/61.png
new file mode 100644
index 0000000..58ea331
Binary files /dev/null and b/opsec/qualitystandard/61.png differ
diff --git a/opsec/qualitystandard/62.png b/opsec/qualitystandard/62.png
new file mode 100644
index 0000000..1bb8499
Binary files /dev/null and b/opsec/qualitystandard/62.png differ
diff --git a/opsec/qualitystandard/index.html b/opsec/qualitystandard/index.html
new file mode 100644
index 0000000..94b5059
--- /dev/null
+++ b/opsec/qualitystandard/index.html
@@ -0,0 +1,270 @@
+
+
+  
+    
+    
+    
+    
+    
+    
+
+    The Quality Standard
+
+    
+    
+	
+    
+    
+
+    
+    
+
+    
+
+    
+    
+  
+
+  
+
+    
+    
+
+	
+	
+	
+
+
+
+ Previous Page

nihilist@mainpc - 2025-03-22

+

The Quality Standard

+

In this tutorial we're going to look at what the quality standard is, to be able to submit good quality tutorials to the blog. We do not consider tutorials that don't follow that standard to be acceptable.

+
+
+
+
+ + +
+
+
+
+

The Quality Standard

+

In order to make sure the content isn't rushed and the quality of the blog overall remains high, we have the following quality standard:

+ +

Rather than writing a gigantic wall of text and loose you halfway, as you can see i made a graph. This is the most effective way of conveying your ideas to your audience, so don't hesitate to make graphs using drawio (with colors preferably) instead of writing walls of text that nobody will read.

+ +

First of all, the general structure of the content is with the Why / What / How methodology This following the minimalistic style where everything that is used and mentionned must be justified. (Everything that has no justification to be there, is to simply be removed.)

+
    +
  1. Why should I care ?

  2. +
  3. What are my options ?

  4. +
  5. How can i implement it ?

  6. +
+ +

Nobody cares about your message until you tell them why they should care. Usually that goes by telling them a short story that they can relate to, in our case it's an opsec scenario that explains what an adversary can do against you.

+

The blog is structured around 3 core scenarios:

+
    +
  1. Privacy: The adversary can see you do something, how can you prevent it ?

  2. +
  3. Anonymity: The adversary knows that it's you who did it, how can you prevent it ?

  4. +
  5. Deniability: The adversary busts down your door, and forces you to open your devices, how can you make sure he doesn't find anything in there ?

  6. +
+

If the scenario of your contribution doesn't fit into (or serve a purpose for) one of those 3, it's most likely off-topic.

+

+Context: In your house, in your bedroom, if there are windows to look outside
+Situation: the annoying neighbor always stops by to look at what you're doing in your bedroom
+Are you ok with this situation ?
+
+
+

So you told your story to highlight the problem, the reader understands that they want privacy. Now you need to tell them the what, what are their options ?

+

+You have a few options to prevent your annoying neighbor from seeing what you're doing in your bedroom:
+1) get rid of all windows and have a house with only walls : expensive
+2) install curtains on your windows : inexpensive
+
+
+

Sidenote: Nobody wants to read a wall of text. HIGHLIGHT the important parts (using the <b></b> tags of your text so that the reader's eye is immediately drawn to what matters most.

+

Now that you laid out the Why, you of course tell them what the best option is, and then you're going to tell them how they can implement it.

+

+Let's showcase how to install curtains, as it's the easiest and cheapest solution to prevent outsiders from seeing what you're doing in your bedroom.
+
+1) buy it, 
+2) then you attach it above your windows, using screws and screwing it into the wall, (warning, if you're living in an apartment, ask for your landlord's permission!)
+3) then you can move the curtain to prevent outsiders from peeking in
+
+
+

But the thing is, we're not lazy blogwriters here, talking about the path is not enough, you are expected to show the readers how you walk that path. This is why the todolists for new blogposts are structured like so:

+

+to be explained: (WHY + WHAT)
+-
+-
+-
+
+to be showcased: (HOW)
+-
+-
+-
+-
+
+
+

In the first part usually there is the to be explained section, where you tell the user why they should care, and what their options are, but afterward there usually is the "to be showcased" part. In that part, you are expected to do a step-by-step tutorial of how to implement the solution which means that you are literally implementing the solution yourself, for yourself, but showing everyone how you're doing it.

+

Let's take a small todolist that is as follows:

+

+to be showcased:
+1)Download grapheneOS (GUI digital step)
+2)Reboot the phone (Physical step)
+3)flash graphene OS on the phone (CLI digital step)
+
+
+ +

Here we have a combination of the 3 possible types of steps you may be expected to showcase, a physical step, a GUI digital step, and a CLI digital step.

+

The first step being a GUI digital step, you need to take a screenshot with arrows, to make it simple i recommend using flameshot like i explained above, to have screenshots like that:

+ +

In the case of the physical step, you need to take a picture, and add arrows in it if needed, like so:

+ +

While editing the html file it will look like that (as you need to put the picture in the same folder as the tutorial you're editing):

+

+<img src="1.png">
+
+
+

If you want to reuse an image from another tutorial like i just did above (it's totally fine), but rather than copying the image from another tutorial and waste diskspace, you can simply reuse the image of another tutorial by adding ../tutorialfolder/ before the path of the image like so:

+

+<img src="../graphene/10.png">
+
+
+

and lastly if you have a CLI step to show, you need to simply copy paste the terminal output in the pre code blocks while still highlighting what's important like so:

+


+<pre><code class="nim">
+
+nowhere# ./flash-all.sh
+Warning: skip copying bootloader_a image avb footer (bootloader_a partition size: 0, bootloader_a image size: 14125140).
+Sending 'bootloader_a' (13794 KB)                  OKAY [  0.364s]
+Writing 'bootloader_a'                             (bootloader) Flashing pack version slider-14.5-11677881
+(bootloader) flashing platform gs101
+(bootloader) Validating partition ufs
+(bootloader) Validating partition partition:0
+
+[...]
+
+OKAY [  3.089s]
+Finished. Total time: 3.454s
+Setting current slot to 'a'                        OKAY [  0.058s]
+Finished. Total time: 0.059s
+Rebooting into bootloader                          OKAY [  0.000s]
+
+[...]
+
+Sending sparse 'super' 11/13 (254972 KB)           OKAY [  6.618s]
+Writing 'super'                                    OKAY [  0.950s]
+Sending sparse 'super' 12/13 (254972 KB)           OKAY [  6.621s]
+Writing 'super'                                    OKAY [  0.935s]
+Sending sparse 'super' 13/13 (46284 KB)            OKAY [  1.216s]
+Writing 'super'                                    OKAY [  0.204s]
+Erasing 'userdata'                                 OKAY [  0.390s]
+Erase successful, but not automatically formatting.
+File system type raw not supported.
+wipe task partition not found: cache
+Erasing 'metadata'                                 OKAY [  0.007s]
+Erase successful, but not automatically formatting.
+File system type raw not supported.
+Finished. Total time: 105.929s
+Rebooting into bootloader                          OKAY [  0.000s]
+Finished. Total time: 0.150s
+nowhere#
+
+</pre></code>
+
+

If there are parts of the commandline output that don't matter, just replace them with [...] in order to stick to what the user needs to see.

+ +

And lastly, if you are someone that makes alot of spelling and grammar mistakes (like me, i know i'm guilty of that aswell), use LTEX+'s addon on vscodium (which is the FOSS version of vscode), it will setup a local LLM that will find your grammar and spelling mistakes:

+

+wget -qO - https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg \
+    | gpg --dearmor \
+    | sudo dd of=/usr/share/keyrings/vscodium-archive-keyring.gpg
+
+echo 'deb [ signed-by=/usr/share/keyrings/vscodium-archive-keyring.gpg ] https://download.vscodium.com/debs vscodium main' \
+    | sudo tee /etc/apt/sources.list.d/vscodium.list
+
+sudo apt update && sudo apt install codium
+
+
+ + + + + + + + + + +

Now using this addon you can find your typos more easily (as it highlights them for you), effectively helping you find and fix them, so if english isn't your first language definitely make sure that you run LTEX+ once after you finished writing your article, so that you don't leave spelling mistakes behind.

+ + +

DISCLAIMER: a blogpost is NOT complete until it follows this quality standard, if you find one that doesn't meet those requirements, do mention it on their gitea issue or ping me directly about it on SimpleX.

+

Same thing if you want to contribute a blogpost that does not meet these quality requirements, i do not care, it is NOT finished until it meets those requirements. Do not be suprised if i refuse your blog contribution for weeks on end if it doesn't meet the requirements. It may take a little more time to do things properly, but at least you're not lowering the quality of the overall blog by following it.

+ +
+
+
+
+
+
+
+
+

Nihilism

+

+ Until there is Nothing left.



Creative Commons Zero: No Rights Reserved
+ +

+
+ +
+

My Links

+

+ + RSS Feed
SimpleX Chat
+ +

+
+ +
+

About nihilist

+

Donate XMR: 8AUYjhQeG3D5aodJDtqG499N5jXXM71gYKD8LgSsFB9BUV1o7muLv3DXHoydRTK4SZaaUBq4EAUqpZHLrX2VZLH71Jrd9k8


Contact: nihilist@contact.nowhere.moe (PGP)

+
+ +
+ +
+
+ + + + + + +