[pLog-general] Wiki status

Oscar Renalias oscar at renalias.net
Sat Dec 11 12:13:22 GMT 2004


First of all, I've given systop status to both you and Brad.

Second, regarding the structure... I like the idea of separating things 
in version but I think that the current version should be always on the 
front page so for example if we now base the contents of the wiki on 
0.3.2, then the "Todo List", "Documentation", "Usage" sections would 
appear right away in the front page. When 1.0 is released and we update 
the wiki contents, then all the old sections would be moved to plog 
0.3.2/Todo list, plog 0.3.2/Documentation etc while the front page 
would have the updated sections for 1.0.

I'm suggesting this because it would save users time if all contents 
are there, facing users right away.

By the way, one important question: are we going to write about 0.3.2 
or 1.0? If I had to choose, I would write about 1.0... It's almost 
feature-complete and it would be nice to have updated documentation by 
the time 1.0 is out!

Also if we use Nick's proposal as the strucutre:

> Todo List
> Documentation
> Usage
> Admin Usage
> Developer Usage
> Themes or Developer Usage/Themes
> Plugins or Developer Usage/Plugins
> Plugin Lists

I will suggest a few changes and make a few questions :)

- Why don't we add a section called "Installation" so that it can be 
clearly seen? (it should probably go on top as the first one) It was 
probably one of the most visited pages in the old wiki!

- What would go into "Documentation"? Or what's the difference between 
"Documentation" and "Usage"?

- I would rename "Developer Usage" as just "Developers" or "For 
developers". I suppose I could add there all the stuff related to 
developing plugins, actions, views, object model, etc.

- I would move "Todo list" away from the top to either inside 
"Developers" or to the bottom of the list...

What do you think?

Regarding locking pages and so on, I agree. Let's try not to receive 
too much spam this time :-) Also regarding things like the "discussion" 
pages, are they really needed? In addition to the mailing lists, forums 
and project blog, do we really want people to leave comments in the 
wiki? In my opinion we shoulnd't, I think that there are enough ways 
for people to express their opinions and that we don't need such 
feature in the wiki...

Oscar

> Howdy,
>
> The format that I'm using with this is pretty loose compared to 
> others. I'm not using the standard wiki words, so in these cases 
> spaces are perfectly acceptable. Each page associated with a plog 
> release follows the following
>
> '<name> <version number>'
>
> Then each sub section has its own page as well. I'm trying to keep 
> with a standard set of sub sections. In this case they are
> Todo List
> Documentation
> Usage
> Admin Usage
> Developer Usage
> Themes or Developer Usage/Themes
> Plugins or Developer Usage/Plugins
> Plugin Lists
>
> With that in mind the wiki entry for plog 0.3.2 would have the 
> following structure.
>
> PLog 0.3.2
> PLog 0.3.2/Todo List
> PLog 0.3.2/Documentation
> PLog 0.3.2/Usage
> PLog 0.3.2/Admin Usage
> PLog 0.3.2/Developer Usage
> PLog 0.3.2/Themes
> PLog 0.3.2/Plugins
>
> Questions, Comments, Suggestions, Flames?
>
> ~ Nick
>
> bcliang wrote:
>
>> Hi guys,
>>
>> I quickly browsed the mediawiki, but am confused at the layout.  There
>> seems to be two separate formats in use, one with the previously
>> mentioned XX: Y(X) format, while others are based on the older wiki
>> page entries.  Additionally, I like the outline for the revision
>> history.  It's done quite nicely.
>>
>> However, what would you guys think about moving the official
>> information from the plogworld.org mainpage and into the wiki (I'm
>> saying migrate the to-do list into the wiki and reference it from
>> home).  It's obvious that having the same information twice may become
>> quite tedious, however much the repeated content may help end-users. 
>> The question is, which location would be ideal?  If we want to grow
>> the wiki I would vote for moving more of the content towards it.  If
>> not for the current release run on the main page, for archived
>> releases (0.1b, 0.2, 0.3, 0.3.1, etc).
>>
>> BTW, mediaWiki seems nice, though it's a bit more complex than the
>> phpWiki I'm used to.  It'll just take some time to feel it out, I
>> guess.
>>
>> On Fri, 10 Dec 2004 09:29:30 -0800, Nick Gerakines 
>> <nick at socklabs.com> wrote:
>>
>>> I started with some minor modifications. I've also started a general 
>>> format for things.
>>> Oscar, please make me my account Sock a site op / site admin. I'm 
>>> probly going to lock
>>> certain pages and start forcing people to use the corrosponding 
>>> XX:Talk pages for public
>>> comments and such.
>>>
>>> I also strongly encourage all of the developers to create user 
>>> accounts and add there
>>> names to the Developers and Contributers lists.
>>>
>>> Message me if anyone has any questions or comments.
>>>
>>> ~ Nick
>>>
>>> Oscar Renalias wrote:
>>>
>>>> I've already been able to install mediawiki, available at
>>>> http://www.plogworld.org/wiki
>>>>
>>>> You need to create a user to be able to edit... How are we going to
>>>> proceed? Copy+paste all the texts from plog.bliang.com/wiki?
>>>>
>>>> Oscar
>>>>
>>> _______________________________________________
>>> pLog-general mailing list
>>> pLog-general at devel.plogworld.net
>>> http://devel.plogworld.net/mailman/listinfo/plog-general
>>>
>>>
>>
>>
>>
>
> _______________________________________________
> pLog-general mailing list
> pLog-general at devel.plogworld.net
> http://devel.plogworld.net/mailman/listinfo/plog-general
>




More information about the pLog-general mailing list