PureBasic Wiki

[Janni]

In addition to the brilliant manual/help file, wouldn't it be good to have a community driven place where anyone could add more example codes ?

This was discussed some weeks back, and Fred kindly provided a wiki for us: https://www.purebasic.com/wiki/index.php/Main_Page

Off course the Wiki will only be valuable if everyone knows about it and starts to contribute. It will probably take time for it to be a meaningful place.
If you know of better examples than what is already in the help file, please help to contribute by adding your examples to the PB Wiki.

PS! When creating a new page, please name it exactly like the commandindex
https://www.purebasic.com/documentation ... index.html

Thank you!

[Axolotl]

Hey Janni, and folks

today I played around with PureBasic Wiki. My goal I wanted to create a few "examples", at least one.
But that did not work....
The only thing I was able to do is editing the About page
I don't have to mention - I think - that this is my first contact with the wiki-edit function.
Who can enlighten me?
TIA.

[Janni]

thanks for trying Axolotl

No WIKI expert myself, but try to add the new page after index.php, for instance:
https://www.purebasic.com/wiki/index.php/ACosH

Then the page will tell you:
There is currently no text in this page. You can search for this page title in other pages, search the related logs, or create this page.

... then please click the "create this page" and try if that works.

A link to all created pages in my signature

[Axolotl]

Ok, thanks Janni

I figured it out and created a first topic.
And now I have the next question....
How can this be found by anyone? Only if you do not know that there is a new topic about editorgadget.
Your Link helps, but I am pretty sure that is not enough...

... We definitely need some templates or whatever it is called for better usability.

And I would like to make a personal comment as a realist.
After reading some wiki stuff and watching a few tutorials on "how to create a corporate wiki" some pages in a basic structue for the start are needed.
I'm sure it will take a person to take the lead on this. Otherwise it will be a complete failure. Patience won't help either.
But anyhow we will see.

PureBasic Wiki - All Pages

[Janni]

Thanks for your contribution Axolotl. It's a start

A <code> like feature that supports PB syntax would be great for better visibility.
For now the Special:AllPages is the best to find all pages I think.

I guess Fred also needs to share his thought on this, whether he commits to keep it or if it just was setup as a test.

[Janni]

My first thought was to make wiki pages based only on the commandindex, but we should not limit to that as they are already explained in the main help file.

What is maybe lacking more are examples on how the library work together.
Instead of examples of one command, like : HTTPRequest, maybe have examples on how the http library work alltogheter.
Same with JSON, File, FTP and all the rest of General libraries, 2D Games & Multimedia Libraries and 3D Games & Multimedia Libraries.

[Fred]

I removed the wiki for now as it wasn't used and bots were spamming it.

[NicTheQuick]

I didn't even knew about it.

[Axolotl]

That is a pity. however, I had expected this. I think that I was the only one who had created (correct) content.
However, many people probably didn't even realize that the wiki existed!

[STARGÅTE]

Two questions arose for me:
1. What should I (as an experienced user) contribute to such a Wiki, except copy&past the documentation?
2. What should a non-experience user find in such a Wiki which he couldn't find in the documentation and the forum?

If it is just the addition of more "helpful" example codes, yes of course, the PureBasic documentation is with in avg one example per function a little bit sparing.
However, then it is a better way to help Fred to improve the documentation instead of creating a different location, which has to be serviced, updated, and moderated.