[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