From dimitris at glezos.com Thu Jun 4 22:12:14 2015 Content-Type: multipart/mixed; boundary="===============2551421168886135903==" MIME-Version: 1.0 From: Dimitris Glezos To: docs at lists.fedoraproject.org Subject: Re: h1 in Wiki Date: Fri, 02 Mar 2007 15:33:14 +0000 Message-ID: <45E843BA.80802@glezos.com> In-Reply-To: 1172824279.4651.516.camel@erato.phig.org --===============2551421168886135903== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable O/H Karsten Wade =CE=AD=CE=B3=CF=81=CE=B1=CF=88=CE=B5: > I've lost track of what we want to appear as a primary header (h1) on a > Wiki page. That is, we sometimes use this: > = > {{{#!html >

Page Title

}}} > = > Is this strictly for visual affect? The above is the same as `=3D=3D Page Title =3D=3D`, so we could just strip= the obfuscation and use the syntax. After ``, `<h1>` is the most important heading. On the wiki, I belie= ve the correct way to use it would be a title-style description of the page. Something like a more decriptive of the pagename. For example: /DocsProject has: =3D The Documentation Project =3D In general, only one h1 should exist on a page, unless the page contents ar= e so disorganized that cannot fit under one category. This does not apply to our= wiki though (we just split the page in two if this happens). > In the case of the Docs/Beats, I think we need to stick to a strict > usage of each page having only one h1 and all other content being a sub: > = > =3D Page Title =3D > = > =3D=3D A Section =3D=3D > ... Correct. The way I see best a wiki page to be structured is shown below. Of course, = Beats don't have a TOC or breadcrumbs. > You are here: Home > Foo > Bar< > = > =3D Page title similar to page name =3D > = > Some text describing the page. No more than 3 paragraphs, no less than on= e. > = > [TableOfContents] > = > =3D=3D Foo section =3D=3D > = > Text that describes/introduces the content of Foo section. > = > =3D=3D=3D Subsection =3D=3D=3D > = > ... > > ---- > CategoryFoo -d -- = Dimitris Glezos Jabber ID: glezos(a)jabber.org, GPG: 0xA5A04C3B http://dimitris.glezos.com/ "He who gives up functionality for ease of use loses both and deserves neither." (Anonymous) -- = --===============2551421168886135903==--