<div dir="ltr"><br><div class="gmail_extra"><div class="gmail_quote">On Mon, Sep 2, 2013 at 10:08 AM, Olle E. Johansson <span dir="ltr"><<a href="mailto:oej@edvina.net" target="_blank">oej@edvina.net</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">Hi!<br>
A few comments:<br>
<br>
- There are no page numbers in this file.<br>
- In the Table of contents, page numbers roll over so after 999 it starts with 101 funny enough.<br>
- it's far too big and the format needs to change to make it manageable.<br>
<br>
As it's too big to be printed, we do need internal hypertext links or someting to navigate.<br>
The TOC needs a TTOC since it's 20 pages...<br>
<br></blockquote><div><br></div><div style>Page numbers shouldn't be too hard to fix. The TOC can also be customized to not drill down as far into the levels. We could drill down only four levels, which would shrink it quite a bit - unfortunately, that would also make it so that the various commands/actions/applications wouldn't be listed in the TOC - which might mean we have to look into a sublisting in those various sections. Something a bit cleaner should be doable however.</div>
<div style><br></div><div style>I'll add one to the list as well: Each page on the wiki needs to correspond to a new page as well. No breaking between the wiki pages does make it difficult to read.<br></div><div><br></div>
<div style>Internal text hyperlinks work for me when I download the PDF. For example, any entry that has a 'See-Also' field in it, I can click on the various applications/commands it references and it jumps me to that page. </div>
</div><div><br></div><div style>As far as size goes, what content should we drop? The reference information probably needs to be there. That's the vast bulk of the documentation. The other options to drop are:</div><div style>
* Getting Started (1.2)</div><div style> * Configuration & Operation (1.3)</div><div style><br></div><div style>The rest of the sections don't really add much length, and wouldn't buy us much by dropping them.</div>
<div><br></div><div style>I put an issue in the issue tracker for this: <a href="https://issues.asterisk.org/jira/browse/ASTERISK-22439">https://issues.asterisk.org/jira/browse/ASTERISK-22439</a>. Any other thoughts?</div>
<div><br></div>-- <br><div dir="ltr"><div>Matthew Jordan<br></div><div>Digium, Inc. | Engineering Manager</div><div>445 Jan Davis Drive NW - Huntsville, AL 35806 - USA</div><div>Check us out at: <a href="http://digium.com" target="_blank">http://digium.com</a> & <a href="http://asterisk.org" target="_blank">http://asterisk.org</a></div>
</div>
</div></div>