On Wednesday 02 September 2009 12:39, Jean Hollis Weber wrote:
> Nino Novak wrote:
> > AFAIK h1-level headers are obsolete for wiki articles (at least in
> > wikipedia).
> >
> > In the (english) documentation (WG2) h1 is used nevertheless, at
> > least in some articles I read so far. The MediaWiki export filter
> > output also uses h1 as top level.
> >
> > Bug or intention?
>
> The English user guides with H1 in some articles were done long
> before I learned anything about how to do wiki articles properly.
> Some of them were done using a set of macros that came before the
> mediawiki export filter that is now in OOo.
>
> Mostly I try to put anything starting with H1 on a new wiki page (so
> it becomes the page title, not a heading on the page)

that's how I'd suggest to proceed (and how I've been doing it too)

> , but sometimes 
> when a section started by a H1 is very short, I keep 2 or 3 of them
> on one wiki page. Then I have to decide whether to change the other
> H1s into H2s.

(As for me, I'd prefer to put them on different pages if their content 
is significantly different)

Wikipedia has a "stub" article avoidance policy. In case of (technical) 
documentation like the UG I don't see any reason for a minimum article 
length. (just my 2ยข)

Nino

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org

Reply via email to