[CaptainOfCoit]

> It’s such a turn off.

Is this the wiki you somehow want to have removed? https://wiki.freepascal.org/

It seems perfectly fine, information-dense even which is even better. Seems a lot better than the typical one-long-landing-page-docs many languages have today. What exactly is the problem with the wiki that cannot be fixed and must be re-made from scratch?

[chungy]

The wiki is full of incomplete, obsolete, or otherwise not-so-useful articles. It suffers from typical "wiki as documentation" efforts, where instead of concentrated efforts from domain experts, you get a thousand half-baked opinions.

It has good stuff, but I'd wager the "bad stuff" outweighs it by a large margin.

[speakspokespok]

Thank you for your response and your example.

The problem is optics. Pretend I'm a brand new user and I want to build GUI applications. I've heard of a language called Freepascal and of an IDE called Lazarus. I think they're connected but I don't know how. And what's Delphi?

Where do I start?

? Welcome to the Free Pascal and Lazarus Wiki [2] https://wiki.lazarus.freepascal.org/

? Lazarus Documentation https://wiki.freepascal.org/Lazarus_Documentation

? Welcome to the Free Pascal and Lazarus Wiki [1] https://wiki.freepascal.org/

? https://www.lazarus-ide.org/

Most IDEs and languages have a Documentation link. Which link do I use to start with?

FreePascal has lazarus docs and Lazarus has FreePascal docs?

As a new user I can slog through 4 different links of schtuff, I guess. (Disappointment and frustration lie ahead; broken old buggy software that doesn't match the documentation. New User doesn't know that yet.) Maybe I'll just look for Youtube videos, but my enthusiasm is draining.

I'm used to this:

https://go.dev/doc/ Everything linked from go.dev/doc works today and it's coherent. Everything.

As other responses mention, the docs as a rule are out of date and confusing.

[1] btw redirects to [2] from search engines.