zeus 4 years ago
parent
commit
10ba98cfc1
  1. 25
      index-lab.adoc
  2. 60
      index-lab.adoc.html
  3. 2159
      index-lab.adoc.pdf

25
index-lab.adoc

@ -210,5 +210,28 @@ A *virtual private network (VPN)* extends a private network across a public netw
== http://http://docs.swarmlab.io/SwarmLab-HowTos/labs/faqs/faq.adoc.html[Frequently Asked Questions^] == http://docs.swarmlab.io/SwarmLab-HowTos/labs/faqs/faq.adoc.html[Frequently Asked Questions^]
== How do I ask a good question?
[TIP]
====
- Introduce the problem before you post any code
In the body of your question, start by expanding on the summary you put in the title.
Explain how you encountered the problem you're trying to solve, and any difficulties that have prevented you from solving it yourself.
The first paragraph in your question is the second thing most readers will see, so make it as engaging and informative as possible.
Help others reproduce the problem
Not all questions benefit from including code. But if your problem is with code you've written, you should include some. But don't just copy in your entire program! Not only is this likely to get you in trouble if you're posting your employer's code, it likely includes a lot of irrelevant details that readers will need to ignore when trying to reproduce the problem. Here are some guidelines:
- Include just enough code to allow others to reproduce the problem. For help with this, read How to create a Minimal, Complete, and Verifiable example.
- If it is possible to create a live example of the problem that you can link to (for example, on http://sqlfiddle.com/ or http://jsbin.com/) then do so - but also copy the code into the question itself. Not everyone can access external sites, and the links may break over time. Use Stack Snippets to make a live demo of inline JavaScript / HTML / CSS.
- *DO NOT post images of code*, data, error messages, etc. - copy or type the text into the question. Please reserve the use of images for diagrams or demonstrating rendering bugs, things that are impossible to describe accurately via text. For more information please see the Meta FAQ entry Why not upload images of code/errors when asking a question?
====

60
index-lab.adoc.html

@ -490,6 +490,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
</ul> </ul>
</li> </li>
<li><a href="#_frequently_asked_questions">5. Frequently Asked Questions</a></li> <li><a href="#_frequently_asked_questions">5. Frequently Asked Questions</a></li>
<li><a href="#_how_do_i_ask_a_good_question">6. How do I ask a good question?</a></li>
</ul> </ul>
</div> </div>
</div> </div>
@ -845,15 +846,70 @@ This tutorial demonstrates some common <strong>nmap</strong> port scanning scena
</div> </div>
</div> </div>
<div class="sect1"> <div class="sect1">
<h2 id="_frequently_asked_questions">5. <a href="http://http://docs.swarmlab.io/SwarmLab-HowTos/labs/faqs/faq.adoc.html" target="_blank" rel="noopener">Frequently Asked Questions</a></h2> <h2 id="_frequently_asked_questions">5. <a href="http://docs.swarmlab.io/SwarmLab-HowTos/labs/faqs/faq.adoc.html" target="_blank" rel="noopener">Frequently Asked Questions</a></h2>
<div class="sectionbody"> <div class="sectionbody">
</div>
</div>
<div class="sect1">
<h2 id="_how_do_i_ask_a_good_question">6. How do I ask a good question?</h2>
<div class="sectionbody">
<div class="admonitionblock tip">
<table>
<tr>
<td class="icon">
<i class="fa icon-tip" title="Tip"></i>
</td>
<td class="content">
<div class="ulist">
<ul>
<li>
<p>Introduce the problem before you post any code</p>
<div class="literalblock">
<div class="content">
<pre>In the body of your question, start by expanding on the summary you put in the title.</pre>
</div>
</div>
<div class="literalblock">
<div class="content">
<pre>Explain how you encountered the problem you're trying to solve, and any difficulties that have prevented you from solving it yourself.</pre>
</div>
</div>
<div class="literalblock">
<div class="content">
<pre> The first paragraph in your question is the second thing most readers will see, so make it as engaging and informative as possible.
Help others reproduce the problem</pre>
</div>
</div>
</li>
</ul>
</div>
<div class="paragraph">
<p>Not all questions benefit from including code. But if your problem is with code you&#8217;ve written, you should include some. But don&#8217;t just copy in your entire program! Not only is this likely to get you in trouble if you&#8217;re posting your employer&#8217;s code, it likely includes a lot of irrelevant details that readers will need to ignore when trying to reproduce the problem. Here are some guidelines:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Include just enough code to allow others to reproduce the problem. For help with this, read How to create a Minimal, Complete, and Verifiable example.</p>
</li>
<li>
<p>If it is possible to create a live example of the problem that you can link to (for example, on <a href="http://sqlfiddle.com/" class="bare">http://sqlfiddle.com/</a> or <a href="http://jsbin.com/" class="bare">http://jsbin.com/</a>) then do so - but also copy the code into the question itself. Not everyone can access external sites, and the links may break over time. Use Stack Snippets to make a live demo of inline JavaScript / HTML / CSS.</p>
</li>
<li>
<p><strong>DO NOT post images of code</strong>, data, error messages, etc. - copy or type the text into the question. Please reserve the use of images for diagrams or demonstrating rendering bugs, things that are impossible to describe accurately via text. For more information please see the Meta FAQ entry Why not upload images of code/errors when asking a question?</p>
</li>
</ul>
</div>
</td>
</tr>
</table>
</div>
</div> </div>
</div> </div>
</div> </div>
<div id="footer"> <div id="footer">
<div id="footer-text"> <div id="footer-text">
Last updated 2020-11-06 10:35:27 UTC Last updated 2020-11-08 15:02:21 UTC
</div> </div>
</div> </div>
</body> </body>

2159
index-lab.adoc.pdf

File diff suppressed because it is too large
Loading…
Cancel
Save