forked from nihilist/blog-contributions
193 lines
9.5 KiB
HTML
193 lines
9.5 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<meta name="description" content="">
|
|
<meta name="author" content="">
|
|
<link rel="shortcut icon" href="../../../../../../assets/img/favicon.png">
|
|
|
|
<title>How to write good Tutorials</title>
|
|
|
|
<!-- Bootstrap core CSS -->
|
|
<link href="../../assets/css/bootstrap.css" rel="stylesheet">
|
|
<link href="../../assets/css/xt256.css" rel="stylesheet">
|
|
|
|
|
|
|
|
<!-- Custom styles for this template -->
|
|
<link href="../../assets/css/main.css" rel="stylesheet">
|
|
|
|
|
|
|
|
<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
|
|
<!--[if lt IE 9]>
|
|
<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
|
|
<script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
|
|
<![endif]-->
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<!-- Static navbar -->
|
|
<div class="navbar navbar-inverse-anon navbar-static-top">
|
|
<div class="container">
|
|
<div class="navbar-header">
|
|
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
|
|
<span class="icon-bar"></span>
|
|
<span class="icon-bar"></span>
|
|
<span class="icon-bar"></span>
|
|
</button>
|
|
<a class="navbar-brand-anon" href="\index.html">The Nihilism Blog</a>
|
|
</div>
|
|
<div class="navbar-collapse collapse">
|
|
<ul class="nav navbar-nav navbar-right">
|
|
|
|
<li><a href="/about.html">About</a></li>
|
|
<li><a href="/blog.html">Categories</a></li>
|
|
<li><a href="https://blog.nowhere.moe/donate.html">Donate</a></li>
|
|
<li><a href="/contact.html">Contact</a></li>
|
|
</ul>
|
|
</div><!--/.nav-collapse -->
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<!-- +++++ Posts Lists +++++ -->
|
|
<!-- +++++ First Post +++++ -->
|
|
<div id="anon2">
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="col-lg-8 col-lg-offset-2">
|
|
<a href="../index.html">Previous Page</a></br></br><p><img src="../../assets/img/user.png" width="50px" height="50px"> <ba>nihilist@mainpc - 2024-08-19</ba></p>
|
|
<h1>How to write good Tutorials </h1>
|
|
<p>Because after all, how can you expect people to write good tutorials without showing them how to write tutorials in the first place ? </p>
|
|
|
|
</div>
|
|
</div><!-- /row -->
|
|
</div> <!-- /container -->
|
|
</div><!-- /grey -->
|
|
|
|
<!-- +++++ Second Post +++++ -->
|
|
<div id="anon3">
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="col-lg-8 col-lg-offset-2">
|
|
<h2><b>Why? </b></h2>
|
|
<p><u>Context:</u> Suppose you are discovering OPSEC, Technology and all their abstract concepts, you are amazed at what you are finding, and you are now feeling very enthusiastic about sharing it to other people, but you don't know how to do it.</p>
|
|
<p><u>Situation:</u> You go into that <a href="https://simplex.chat/contact#/?v=2-7&smp=smp%3A%2F%2FL5jrGV2L_Bb20Oj0aE4Gn-m5AHet9XdpYDotiqpcpGc%3D%40nowhere.moe%2FH4g7zPbitSLV5tDQ51Yz-R6RgOkMEeCc%23%2F%3Fv%3D1-3%26dh%3DMCowBQYDK2VuAyEAkts5T5AMxHGrZCCg12aeKxWcpXaxbB_XqjrXmcFYlDQ%253D&data=%7B%22type%22%3A%22group%22%2C%22groupLinkId%22%3A%22c3Y-iDaoDCFm6RhptSDOaw%3D%3D%22%7D">SimpleX chatroom</a> you find that random dude called <a href="https://matrix.to/#/@nihilist:nowhere.moe">nihilist</a> and you start to explain into great detail how you managed to implement QubesOS with that whonix Xen VM, and that he should also force a VPN through the SOCKS Tor proxy and you proclaim that this is the ultimate setup, and everyone should implement it. <b>But before you can finish your ramblings the guy already ran away scared, he thought you were threatening him and his family.</b></p>
|
|
<p> Are you OK with how badly you just communicated ? Are you fine with shouting your message out there without firmly grabbing anyone's attention?</p>
|
|
</div>
|
|
</div><!-- /row -->
|
|
</div> <!-- /container -->
|
|
</div><!-- /white -->
|
|
|
|
<div id="anon2">
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="col-lg-8 col-lg-offset-2">
|
|
<h2><b>What?</b></h2> </br> </br>
|
|
<p>There exists a process, that this guy nihilist is using all the time on his OPSEC Blog, which is in 3 simple steps:</p>
|
|
<ol>
|
|
<li><p><b>Why ?</b> Why the hell should others care about your message in the first place ? In which context ?</p></li>
|
|
<li><p><b>What ?</b> If they care, What are the tools at their disposal to solve that problem ?</p></li>
|
|
<li><p><b>How ?</b> How, step by step, can they use those tools to solve the problem ?</p></li>
|
|
</ol>
|
|
<p><b>Don't mix up the order.</b> First the Why, then the What, then the How.</p>
|
|
|
|
</div>
|
|
</div><!-- /row -->
|
|
</div> <!-- /container -->
|
|
</div><!-- /white -->
|
|
|
|
|
|
<!-- +++++ Second Post +++++ -->
|
|
<div id="anon1">
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="col-lg-8 col-lg-offset-2">
|
|
<h2><b>How ?</b></h2> </br> </br>
|
|
<p>Now that you are aware that there is a way to write good quality tutorials, let's look at how to write them, step by step.</p>
|
|
<p>First, ALWAYS start with the <b>WHY</b>, why the hell should all those mortals even care about your message. <b>To do that, you need to tell them a story that highlights a problem</b>. Most people may not even aware that there is a problem in the first place, so you must tell them, to make them aware of it.</p>
|
|
|
|
<p> So you first contextualize your story, then you explain the situation, and then you ask them if they are ok with it.</p>
|
|
<pre><code class="nim">
|
|
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 ?
|
|
|
|
</pre></code>
|
|
<p>Now that the problem has been highlighted, you can tell them <b>WHAT</b> their options are:</p>
|
|
<pre><code class="nim">
|
|
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
|
|
|
|
</pre></code>
|
|
<p>Now that you have listed their options, you can showcase <b>HOW</b> to implement an option you choose</p>
|
|
<p><B>WARNING: people don't want to read your wall of text</b>, one way to make it fancy is to add graphs to help your readers visualize the idea you are trying to convey:</p>
|
|
|
|
<img src="0.png" class="imgRz">
|
|
<pre><code class="nim">
|
|
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
|
|
|
|
</pre></code>
|
|
<p>Do not skip steps, otherwise your readers will get lost. and explain each step in great detail, that way there is no ambiguity. To reduce the ambiguity, show what you're seeing when you are doing the steps yourself (take pictures, copy paste from your terminal, etc)</p>
|
|
<p>If there are any important points that your readers need to be aware of, make sure you tell them, and how they can proceed in that second situation too. It is important to make sure they understand the why along each step they do.</p>
|
|
<p>And finally, congratulate your users as you conclude on what they managed to accomplish:</p>
|
|
<pre><code class="nim">
|
|
Congratulations, you just managed to gain privacy at your own house / apartment ! You just reached OPSEC level 1!
|
|
|
|
</pre></code>
|
|
<p>Congratulations, you just managed to write a good tutorial, you highlighted why your users should care about your message, and if they care you just told them how they can solve the problem ! You now have the proper methodology to write top quality tutorials, and to communicate in a clear, and concise manner.</p>
|
|
|
|
</div>
|
|
</div><!-- /row -->
|
|
</div> <!-- /container -->
|
|
</div><!-- /white -->
|
|
|
|
<!-- +++++ Footer Section +++++ -->
|
|
|
|
<div id="anonb">
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="col-lg-4">
|
|
<h4>Nihilism</h4>
|
|
<p>
|
|
Until there is Nothing left.</p></br></br><p>Creative Commons Zero: No Rights Reserved</br><img src="\CC0.png">
|
|
|
|
</p>
|
|
</div><!-- /col-lg-4 -->
|
|
|
|
<div class="col-lg-4">
|
|
<h4>My Links</h4>
|
|
<p>
|
|
|
|
<a target="_blank" rel="noopener noreferrer" href="http://blog.nowhere.moe/rss/feed.xml">RSS Feed</a><br/><a target="_blank" rel="noopener noreferrer" href="https://simplex.chat/contact#/?v=2-7&smp=smp%3A%2F%2FL5jrGV2L_Bb20Oj0aE4Gn-m5AHet9XdpYDotiqpcpGc%3D%40nowhere.moe%2FH4g7zPbitSLV5tDQ51Yz-R6RgOkMEeCc%23%2F%3Fv%3D1-3%26dh%3DMCowBQYDK2VuAyEAkts5T5AMxHGrZCCg12aeKxWcpXaxbB_XqjrXmcFYlDQ%253D&data=%7B%22type%22%3A%22group%22%2C%22groupLinkId%22%3A%22c3Y-iDaoDCFm6RhptSDOaw%3D%3D%22%7D">SimpleX Chat</a><br/>
|
|
|
|
</p>
|
|
</div><!-- /col-lg-4 -->
|
|
|
|
<div class="col-lg-4">
|
|
<h4>About nihilist</h4>
|
|
<p style="word-wrap: break-word;"><u>Donate XMR:</u> 8AUYjhQeG3D5aodJDtqG499N5jXXM71gYKD8LgSsFB9BUV1o7muLv3DXHoydRTK4SZaaUBq4EAUqpZHLrX2VZLH71Jrd9k8</p></br><p><u>Contact:</u> nihilist@contact.nowhere.moe (<a href="https://nowhere.moe/nihilist.pubkey">PGP</a>)</p>
|
|
</div><!-- /col-lg-4 -->
|
|
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<!-- Bootstrap core JavaScript
|
|
================================================== -->
|
|
<!-- Placed at the end of the document so the pages load faster -->
|
|
|
|
</body>
|
|
</html>
|