Merge pull request 'Add procedure for blog updates' (#281) from oxeo0/blog-contributions:contribution-update-blog into main

Reviewed-on: http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/nihilist/blog-contributions/pulls/281
This commit is contained in:
nihilist 2025-04-02 21:15:23 +02:00
commit ac519feb0d
8 changed files with 45 additions and 5 deletions

BIN
opsec/contribute/70.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.9 KiB

BIN
opsec/contribute/71.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.8 KiB

BIN
opsec/contribute/72.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.9 KiB

BIN
opsec/contribute/73.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.5 KiB

BIN
opsec/contribute/74.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.9 KiB

BIN
opsec/contribute/75.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.6 KiB

BIN
opsec/contribute/76.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.2 KiB

View file

@ -60,7 +60,7 @@
<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-10-06</ba></p>
<a href="../index.html">Previous Page</a></br></br><p><img src="../../assets/img/user.png" width="50px" height="50px"> <ba>nihilist@mainpc - 2025-04-03</ba></p>
<h1>How to become a Contributor </h1>
<p>In this tutorial we're going to look at how you can contribute to the opsec blog, we'll look into how the work is being organized, and how to contribute via gitea.</p>
<p><img src="../logos/daturagit.png" style="width:100px"> <u>Sidenote:</u> Help us improve this tutorial by letting us know if there's anything missing or incorrect on this <a href="http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/nihilist/blog-contributions/issues/275">git issue</a> directly!</p>
@ -110,7 +110,6 @@ To be showcased:
<img src="5.png" class="imgRz">
<p>After discussing with me what task you want to do, we'll confirm on the price for that tutorial and after i get your confirmation i'll assign it to you, and that's when you can start to work on it.</p>
<p><u>Disclaimer:</u> if you're not used to writing technical stuff, please aim for the tutorials that are labeled as "Simple" and that you actually understand. Don't try to bite more than you can chew, otherwise i might refuse further contributions coming from you. You should be at least familliar with the topic you intend to talk about.</p>
<p><img src="../logos/daturagit.png" style="width:100px"> <u>Sidenote:</u> Help us improve this tutorial by letting us know if there's anything missing or incorrect on this <a href="http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/nihilist/blog-contributions/issues/275">git issue</a> directly!</p>
</div>
</div><!-- /row -->
@ -141,7 +140,7 @@ To be showcased:
<div class="container">
<div class="row">
<div class="col-lg-8 col-lg-offset-2">
<h2>How to contribute new tutorials</h2>
<h2 id="how-to-contribute">How to contribute new tutorials</h2>
<p>Now you first need to sign up on gitea, just <a href="https://simplex.chat/contact#/?v=2-7&smp=smp%3A%2F%2FBD4qkVq8lJUgjHt0kUaxeQBYsKaxDejeecxm6-2vOwI%3D%40b6geeakpwskovltbesvy3b6ah3ewxfmnhnshojndmpp7wcv2df7bnead.onion%2FpyfV2wlxrcepw8g2OHINsMNuVmpsZsAo%23%2F%3Fv%3D1-3%26dh%3DMCowBQYDK2VuAyEAgePBM9B_duSC7yFaBWI8Dp_jJO62NpTwJN2wsAXeQis%253D&data=%7B%22groupLinkId%22%3A%22rrxS6sZIQHHjO9RUJsjrVA%3D%3D%22%7D">ping me directly on SimpleX</a> so that i create your account manually.</p>
<img src="../maintainers/1.png" class="imgRz">
<p>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:</p>
@ -329,9 +328,9 @@ To http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/6dv
<img src="14.png" class="imgRz">
<img src="15.png" class="imgRz">
<img src="16.png" class="imgRz">
<p>now from there your pull request is created, and i'll review it as soon as i get the time:</p>
<p>now from there your pull request is created, and I'll review it as soon as I get the time:</p>
<img src="17.png" class="imgRz">
<p>If it's not complete, i'll comment in there asking you to add what's missing, <b>changes that you must actually finish before the deadline.</b> To add further changes simply add more commits to it</p>
<p>If it's not complete, I'll comment in there asking you to add what's missing, <b>changes that you must actually finish before the deadline.</b> To add further changes simply add more commits to it</p>
<pre><code class="nim">
[ mainpc ] [ /dev/pts/18 ] [~/Documents/blog-contributions]
→ vim opsec/newtutorial/index.html
@ -378,6 +377,47 @@ Writing objects: 100% (5/5), 432 bytes | 432.00 KiB/s, done.
</div> <!-- /container -->
</div><!-- /grey -->
<!-- +++++ Footer Section +++++ -->
<!-- +++++ Second Post +++++ -->
<div id="anon2">
<div class="container">
<div class="row">
<div class="col-lg-8 col-lg-offset-2">
<h2 id="updating-existing-tutorials"><b>Updating existing tutorials</b></h2>
<p>Sometimes it happens that a tutorial is outdated, has errors or just needs some methodology updates. If you have an idea for something that could be added, or if you want to fix some errors in the tutorial, contact us on simplex or open an issue on <a href="http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/nihilist/blog-contributions/issues">gitea</a>. We will discuss the changes and make sure they're going in the right direction. If it's a small change (like fixing typos or modifying just a few sentences), you can make a pull request with the changes without contacting us.</p>
<p>Usually, there are already a few issues for blog updates listed on the <a href="http://git.nowherejezfoltodf4jiyl6r56jnzintap5vyjlia7fkirfsnfizflqd.onion/nihilist/blog-contributions/projects/1">project board</a>. If you want to help, feel free to pick one and start working on it.<br>
The steps are similar to what we have for <a href="#how-to-contribute">creating new tutorial</a> - fork the repository, create a branch and edit appropriate blog post. When you're done with your changes, open a pull request so that we can review them.</p>
<p>Depending on how much of the tutorial is actually changed, you should credit yourself accordingly. For the sake of this example, let's say you're <b>oxeo0</b> (the person making an update) and <b>Nihilist</b> is the original author of the blog post.</p>
<h2><b>Small change</b></h2>
<p>If the changes you've made are small (let's say less than 20% of the blog post), you should keep the name of the original author. You may change the date to inform readers it has been changed recently, but this is not strictly required. Do not add your XMR address in the footer. This doesn't mean that you won't be getting paid. If you're working on an issue on the project board, there's often a reward even for small edits.</p>
<img src="71.png">
<img src="70.png">
<h2><b>Considerable change</b></h2>
<p>If the changes you've made are considerable (let's say more than 20% of the blog post), you should credit yourself and the original author. Mention the tutorial has been updated by you at the top and keep both yours and author's XMR address in the footer.</p>
<img src="72.png">
<img src="73.png">
<h2><b>Complete rewrite</b></h2>
<p>Sometimes the tutorial needs to be rewritten entirely (more than 90% changes). In this case, you can treat the tutorial as if it was written by you from the beginning.</p>
<img src="74.png">
<img src="75.png">
<h2><b>Special Case - Collaboration</b></h2>
<p>If there is more than one person working on the tutorial, credit all as authors and list their XMR addresses.</p>
<img src="76.png">
<img src="73.png">
</div>
</div><!-- /row -->
</div> <!-- /container -->
</div><!-- /white -->
<div id="anonb">
<div class="container">
<div class="row">