Loading...
 
Documentation

Documentation


Re: Questions about the state of doc.t.o

posts: 3665 United States

Welcome! And a hearty "thanks" for taking on the docs...

pops wrote:

Now we are stuck with two paralel systems which is confusing to say the least. So my main question today is:
Is the old "documentation toc" structure ready to disappear? If not, what still needs to be done?

Not yet (as there's still no completed "User Guide" for the doc). Ideally, we could have all the structures remain, but we really need a way to have a default structure (there's an open Enhancement Request for this), because when a page opens that belongs to two (or more) structures, end-users get no notification at all. :-(

pops wrote:
The idea is to have a user centric page on how to create simple links, mostly via editing icons in the user guide structure, and keep the gory details for the admins in the "tiki reference guide" structure

This was/is the goal of the initial doc revamp (many moons ago). The "User Guide" is meant for end-users of Tiki-powered sites; the "Reference Guide" is meant for Tiki admins.

pops wrote:

At last, an OT note: I support the minor alternative layout modification proposed here:
http://doc.tiki.org/Tiki+Manual+of+Style&no_bl=y#Page_Titles(external link)
The first paragraph of a page should not be the page title. The page title should be displayed above the page or the description made bigger.

I don't think I understand your item... The page name may be different than the page's title. On doc.t.o, page names are not displayed by default — on the typed-in page name.

HTH,

- Rick | My Tiki Blog | My Tiki UserPage

Why be a dummy? Get smarty! TikiForSmarties.com
Tiki for Smarties, your source for the best (and only) Tiki books, guides, and tutorials.
There are no comments at this time.

Upcoming Events

1)  18 Apr 2024 14:00 GMT-0000
Tiki Roundtable Meeting
2)  16 May 2024 14:00 GMT-0000
Tiki Roundtable Meeting
3)  20 Jun 2024 14:00 GMT-0000
Tiki Roundtable Meeting
4)  18 Jul 2024 14:00 GMT-0000
Tiki Roundtable Meeting
5)  15 Aug 2024 14:00 GMT-0000
Tiki Roundtable Meeting
6)  19 Sep 2024 14:00 GMT-0000
Tiki Roundtable Meeting
7) 
Tiki birthday
8)  17 Oct 2024 14:00 GMT-0000
Tiki Roundtable Meeting
9)  21 Nov 2024 14:00 GMT-0000
Tiki Roundtable Meeting
10)  19 Dec 2024 14:00 GMT-0000
Tiki Roundtable Meeting