[documentation] [Documentation feature] Proposal: How to get
more people involved with documentation
Charlie Lowe
cel4145 at cyberdash.com
Wed Jun 7 02:21:36 UTC 2006
sime wrote:
>
> Don't forget Full-HTML rights. ;-)
May not be necessary. We may just need to update the filtered HTML tag
allowances to provide for those tags that need to be used for handbook
pages. This avoids the security risk mentioned by Amazon (later email in
thread).
This is the current allowed list:
<h1> <h2> <h3> <h4> <h5> <h6> <em> <strong> <code> <del> <blockquote>
<q> <sub> <p> <br> <pre> <ul> <ol> <li> <dl> <dt> <dd> <a> <b> <u> <i> <sup>
Is there anything there that needs adding? We could discuss that
possibility and the security risks. For the most part, I believe that
these tags cover construction of 99% of the existing handbook.
>
> We shouldn't forget that, with this and other suggestions, there is the
> question of:
> - how to ensure compliance to the style guide.
> - how to manage the creation of (duplicate) pages, adhoc in
> inappropriate sections of the handbook
IMHO, good content comes before these two. I would imagine users of the
handbook would probably prefer that there be more good content--at the
expense of style consistency and some duplication--than not.
More information about the documentation
mailing list