zeus 4 years ago
parent
commit
59a9e8f9fb
  1. 6
      index-lab.adoc
  2. 12
      index-lab.adoc.html
  3. 1278
      index-lab.adoc.pdf

6
index-lab.adoc

@ -214,16 +214,18 @@ A *virtual private network (VPN)* extends a private network across a public netw
== How do I ask a good question?
[TIP]
[NOTE]
====
- Introduce the problem before you post any code
- Help others reproduce the problem
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:

12
index-lab.adoc.html

@ -854,17 +854,20 @@ This tutorial demonstrates some common <strong>nmap</strong> port scanning scena
<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">
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-tip" title="Tip"></i>
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="ulist">
<ul>
<li>
<p>Introduce the problem before you post any code</p>
</li>
<li>
<p>Help others reproduce the problem</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>
@ -877,8 +880,7 @@ This tutorial demonstrates some common <strong>nmap</strong> port scanning scena
</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>
<pre>The first paragraph in your question is the second thing most readers will see, so make it as engaging and informative as possible.</pre>
</div>
</div>
</li>
@ -909,7 +911,7 @@ Help others reproduce the problem</pre>
</div>
<div id="footer">
<div id="footer-text">
Last updated 2020-11-08 15:02:21 UTC
Last updated 2020-11-08 15:36:58 UTC
</div>
</div>
</body>

1278
index-lab.adoc.pdf

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