[Slackdocs] Great effort - how do I start?

x y x77 at shaw.ca
Fri Aug 24 04:31:16 CEST 2012


On 08/23/2012 02:39 PM, Nocturnal Slacker wrote:
> I agree. We definitely need to get the basic structure and plan in 
> place before we stray off on tangents. You'll just need to 
> occasionally wrangle (as the cowboys do with cows) us all and point us 
> in the direction we need to be following.
>
> I had wanted to post a couple of howtos. This was the only reason I 
> slid slightly off-topic.
>
> I have to attend to real life for a while. I shall return... ;)
>
> ~V. T. Eric Layton, Nocturnal Slacker
>
> On 08/23/2012 05:22 PM, Eric Hameleers wrote:
>> Op 23-8-2012 22:58, Nocturnal Slacker schreef:
>>> That is pretty cool! This was actually a question that I was about
>>> to ask. So, basically new page creation is done by creating the link
>>> with the main domain URL + TOC heading + page title. Is this correct?
>>
>> New page creation is done by typing a URL with a page name which does
>> not yet exist. The Wiki assumes that your intention is to add that
>> page and shows you the appropriate controls.
>>
>>> If you create a page using a TOC sub-heading that doesn't exist,
>>> does the wiki still create the page and later allow of TOC
>>> modification by staff to add the new sub-heading?
>>
>> The page will always be created. Theoretically it is totally
>> irrelevant whether you use a namespace or a cascade of namespaces (
>> like http://docs.slackware.com/wiki:user:nocturnal.slacker ) because
>> the Wiki search function, the recent changes page and the site index
>> give you ways of finding back your page.
>>
>> To make your page be found more readily, you would add a link to your
>> page inside another (already existing) wiki page. That is the manual
>> approach.
>>
>> What I want to achieve through the use of page tags (the {{tag>foo
>> bar}} markup you see at the bottom of several pages) is to have
>> auto-populating TOC pages. Having to manually update the TOC is
>> nobody's favourite job, so we will let the Wiki do all the work.
>>
>> But not just creating Tables Of Contents is possible. For instance, I
>> created http://docs.slackware.com/tag:needs_attention as an aggregator
>> for pages that have the "needs_attention" tag. This empowers anyone to
>> flag a page and if the admin team checks the aggregation page
>> regularly we have an asynchronous means of communication about issues
>> with pages.
>>
>> There is so much more we can do with the Wiki. But lets focus on
>> getting the guidelines for authors and editors written up so that we
>> can work from a joint perspective. Then we can draft up the TOC pages.
>>
>> On 08/23/2012 03:57 PM, Eric Hameleers wrote:
>>>
>>>> You just type a url like http://docs.slackware.com/howtos:my_new_howto
>>>> , click "create this page" and see what happens.
>>>
>>
Alright, this sounds like a good idea. 14 years of linux (not all Slack) 
to dedicate. Unfortunately, I only speak and write english. Anything you 
guys need... that's within my grasp is yours. ANYTHING.

flip



More information about the Slackdocs mailing list