-
-
Notifications
You must be signed in to change notification settings - Fork 103
Description
The "Welcome" page closes with:
To get help, please see [[help-en/Home]]
However, the help-en/Home page starts with two not very helpful tests:
Test Comment
Click the Comments link to show/hide comments:
Test Transclusion
Click the Transclusions link to show the content of the transclusions below:
This is some test content on a sub-item of Home.
A transclusion: help-common/logo.png
(and it does not even tell, that the mentioned links are outside the page on a toolbar...)
I don't think this is the first thing a user (or new developer) wants to see when looking for help.
Next is a section "Parsers with Auto Scroll", describing an advanced feature that does not work here (Debian, Firefox, local Moin server). (Double clicking in the text area does not "move to the modify view and auto-scroll the edit textarea to the line clicked" but marks a word.)
Only after scrolling down, I can reach the first interesting part: a list of supported markups with links to the respective documentation (where "moin wiki" has two, differently named links to the same sub-page).
Suggestion:
Make the help home a start page with a selection of links to the parts relevant for using Moin
(cf. https://moin-20.readthedocs.io/en/latest/index.html#using-moinmoin).
Keep a sub-item with samples that demonstrate the rendering of different source formats
to allow, e.g., to access the impact of changes to CSS themes and common.css.