Yes, the KB Active Sections/Chapters
needs to be associated with the Expert Features
and is only relevant to experts who are modifying that top level structure.
Most users only modify or create pages lower down in the structure that is not mentioned in that expert advice.
Those users must already know how to navigate the KB
and thus have a basic understanding of its structure in order to reach the Page
they want to edit and to find the Contribute Your Knowledge
chapter. It is rather like your argument that explaining Hyperlinks
is unnecessary for such users.
As explained above, I don't think Create And Manage Pages
needs an intro to Wiki structure.
According to Tools > Old Revisions
you created Creating a New Namespace
on 2018/11/28 14:28 Relative v Absolute
~ I hear what you are saying, but as I said in 1.
earlier, Create And Manage Pages
specifically advises to use Relative Links
such as [[One New Page]] and [[.:New Subsection:Index]] to create new pages. Also Links within the Knowledge Base
advises a Relative Link
of [[Edit Links and Media#Links within the Knowledge Base]] for bookmarking. They make no sense in the context of all the Absolute Links
unless we explain to two formats.
The advantages of Relative Links
are similar to FH
relative v absolute Media File Paths
If a Page
were to use Absolute Namespaces
for bookmarking cross-references within its own (or sibling Page) section headings, then as soon as any Namespace higher up the hierarchy was changed all those bookmarks would become broken links.
I know there is a workaround by asking Jane to perform a global edit to fix the broken links, but it does carry some risk.
The icon when hovering over a section Headline, or the asterisk in the Trace, produces an absolute link for pasting into Forum
topics as explained in the Forum Usage Guide (4252)
. Perhaps we need to reiterate that in our guides.Namespace Conventions
~ Absolute Links
are straightforward and as you say, all the tools drive the user that way.
~ Relative Links
are much easier for creating new pages, because you just enter the new Page
name and don't need to know anything about the structure above ~ simples!
I've realised there are other conventions we have not mentioned:
- The [[One New Page]] and [[.:New Subsection:Index]] links are converted to a Namespace by replacing any sequence of non-alphanumerics with an underscore and converting to lower case, i.e. one_new_page and .:new_subsection:index
- The new page top level headline is automatically created from the link name, i.e. ===== One New Page =====
So perhaps we do need a Namespace Conventions
topic that starts with those generic DokuWiki
syntax rules, and progresses through our KB
names and structure. But where does it fit amongst the existing topics?Absolute Crossreferences
are straightforward because you only have to hover on a Headline
to to see its Namespace
and the Link Wizard
allows navigation to namespaces whose names match Headlines in most cases.
Shall we agree to call top level sections Chapters