This is a multipart message in MIME format.
--=_alternative 006108C983256BB5_Content-Type: text/plain;
charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
just a suggestion, folks
isn=B4t time to setup a shorewall-doc@ list or something in the likes? I=B4d=20
like to lurke around a bit before jumping in, but I am not interested (or=20
have the time in the moment) to read all developers list.
I have worked 4 or 5 years in the past producing documentation and=20
training material for a pletora of systems (from end-user to IT products)=20
and I think I can help DSG in some ways.
sorry if this has already been discussed before,=20
Eduardo Ferreira
"Ron Shannon" <rshannon@cruzcom.com>
Sent by: shorewall-users-admin@shorewall.net
10/05/2002 14:02
=20
To: <shorewall-users@shorewall.net>,
<shorewall-devel@shorewall.net>
cc: (bcc: Eduardo Ferreira/RJ/BANCO/ICATU)
Subject: [Shorewall-users] Help Improve the Shorewall Docs
At Tom Eastep''s request, an informal Shorewall Documentation Support
Group
(DSG) is hoping to relieve some of the writing and editing burdens that=20
come with maintaining and improving the Shorewall documentation. The DSG=20
welcomes and needs your suggestions and contributions about all aspects of
the documentation, including structure, content, references, style,=20
grammar -- whatever!
The first project will be to upgrade the Quick Start Guide and Samples,=20
which are intended to be a complete but concise reference for newcomers,=20
with links and other references to details and advanced topics. Later=20
projects will probably include work on other parts of the docs. Although=20
suggestions concerning all parts of the documentation are welcome,=20
comments from the perspective of first-time users will be particularly=20
helpful in updating the Quick Start Guide and Samples. In order to prime=20
your "suggestion pump" please take a moment to think about these=20
(non-exclusive) questions:
1) Is the current Quick Start Guide (QSG) missing important information=20
and if so, what?
2) Should the contents of the QSG be ordered differently and if so, how?
3) What parts (if any) of the QSG were confusing during your initial=20
installation?
4) Did you start with one of the Samples? If so, which one and how well=20
did it work for you?
5) Are additional generic Samples needed and if so, for what topology=20
and/or policy models?
6) How do you think the comments in the Samples files could be improved?
Please email comments to the development list
(mailto:shorewall-devel@shorewall.net). If you would like to join in helping
with writing or editing, please=20
indicate what you''d like to do. Thanks for your help!
=20
=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F
Shorewall-users mailing list
Shorewall-users@shorewall.net
http://www.shorewall.net/mailman/listinfo/shorewall-users
--=_alternative 006108C983256BB5_Content-Type: text/html;
charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
<br><font size=3D2 face=3D"sans-serif">just a suggestion,
folks</font>
<br>
<br><font size=3D2 face=3D"sans-serif">isn=B4t time to
setup a shorewall-doc@ list or something in the likes? I=B4d like to
lurke around a bit before jumping in, but I am not interested (or have the time
in the moment) to read all developers list.</font>
<br>
<br><font size=3D2 face=3D"sans-serif">I have worked 4 or
5 years in the past producing documentation and training material for a pletora
of systems (from end-user to IT products) and I think I can help DSG in some
ways.</font>
<br>
<br><font size=3D2 face=3D"sans-serif">sorry if this has
already been discussed before, </font>
<br>
<br><font size=3D2 face=3D"sans-serif">Eduardo
Ferreira</font>
<br>
<br>
<br>
<br>
<table width=3D100%>
<tr valign=3Dtop>
<td>
<td><font size=3D1
face=3D"sans-serif"><b>"Ron Shannon"
<rshannon@cruzcom.com></b></font>
<br><font size=3D1 face=3D"sans-serif">Sent by:
shorewall-users-admin@shorewall.net</font>
<p><font size=3D1 face=3D"sans-serif">10/05/2002
14:02</font>
<br>
<td><font size=3D1 face=3D"Arial">
</font>
<br><font size=3D1 face=3D"sans-serif">
To:
<shorewall-users@shorewall.net>,
<shorewall-devel@shorewall.net></font>
<br><font size=3D1 face=3D"sans-serif">
cc:
(bcc: Eduardo Ferreira/RJ/BANCO/ICATU)</font>
<br><font size=3D1 face=3D"sans-serif">
Subject:
[Shorewall-users] Help Improve the Shorewall
Docs</font></table>
<br>
<br>
<br><font size=3D2 face=3D"Courier New">At Tom
Eastep''s request, an informal Shorewall Documentation Support Group
(DSG) is hoping to relieve some of the writing and editing burdens that come
with maintaining and improving the Shorewall documentation. The DSG welcomes and
needs your suggestions and contributions about all aspects of the documentation,
including structure, content, references, style, grammar -- whatever!<br>
<br>
The first project will be to upgrade the Quick Start Guide and Samples, which
are intended to be a complete but concise reference for newcomers, with links
and other references to details and advanced topics. Later projects will
probably include work on other parts of the docs. Although suggestions
concerning all parts of the documentation are welcome, comments from the
perspective of first-time users will be particularly helpful in updating the
Quick Start Guide and Samples. In order to prime your "suggestion
pump" please take a moment to think about these (non-exclusive)
questions:<br>
<br>
1) Is the current Quick Start Guide (QSG) missing important
information and if so, what?<br>
2) Should the contents of the QSG be ordered differently and if so,
how?<br>
3) What parts (if any) of the QSG were confusing during your initial
installation?<br>
4) Did you start with one of the Samples? If so, which one and how
well did it work for you?<br>
5) Are additional generic Samples needed and if so, for what topology
and/or policy models?<br>
6) How do you think the comments in the Samples files could be
improved?<br>
<br>
Please email comments to the development list
(mailto:shorewall-devel@shorewall.net). If you would like to join in helping
with writing or editing, please indicate what you''d like to do. Thanks
for your help!<br>
<br>
=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F=5F<br>
Shorewall-users mailing list<br>
Shorewall-users@shorewall.net<br>
http://www.shorewall.net/mailman/listinfo/shorewall-users<br>
</font>
<br>
<br>
--=_alternative 006108C983256BB5_=--