[Lazarus] Missing Documentation

Vincent Snijders vincent.snijders at gmail.com
Thu Mar 1 16:43:19 CET 2012


Op 1 maart 2012 14:28 heeft Hans-Peter Diettrich
<DrDiettrich1 at aol.com> het volgende geschreven:
> Vincent Snijders schrieb:
>
>> Op 1 maart 2012 08:12 heeft Graeme Geldenhuys
>> <graemeg.lists at gmail.com> het volgende geschreven:
>>>
>>> On 1 March 2012 02:22, Hans-Peter Diettrich  wrote:
>>>>
>>>> The results are very strange. Entering "documentation" finds almost all
>>>> pages, because these have this keyword in the headline and navigation
>>>> menu.
>>>
>>>
>>> It even finds result pages where the entered word doesn't appear
>>> _anywhere_ in the wiki page. Not the header, not the navigation, not
>>> the body. See my example about "freebsd" and the tiOPF result page.
>>>
>>> The wiki is utterly useless and broken!! If you don't know the
>>> directly link to what you are looking for, chances are you will never
>>> find it.
>>
>>
>> I guess you mean: I cannot use the wiki. Or: the index page doesn't
>> work like a search page. Or: the textbox on the index page doesn't
>> work like I expect.
>>
>> In that case, you should not use the wiki, but it is not broken.
>
>
> Either case indicates the lack of a description, required to use an existing
> feature. This is one more example of the different viewpoints of
> implementors and users. When an implementor *believes* that no documentation
> is required, he may be the only one who ever uses his great invention.

Lack of reading the label, or lack of understanding what means
"Display pages starting at:"
Remember: this is the *index* page. The text part asks you what part
of the index to show.

>
>
>>
>> If you type in freebsd, it shows a page with all pages whose name
>> start with freebsd
>
>
> No such pages exist, all names start with a capital letter.

False:
e.g. http://wiki.lazarus.freepascal.org/fcl-base

>
>
>> or are later in the alphabetically, case sensitive
>> sorted index of pages.
>
>
> What is "are later"? All pages starting with 'g'..'z'?

Yes, but not A .. Z and a .. e.

>
>
>> It doesn't say anything about the contents of
>> the page, just about its name.
>
>
> This finally makes some sense.

Glad you understood.

Vincent




More information about the Lazarus mailing list