Slackware Documentation Project

dugan · 08-17-2012, 06:07 PM

Two suggestions for hosting are nearlyfreespeech.net (practically free) and OpenShift (free, and by Redhat).

etech3 · 08-17-2012, 06:22 PM

Eric

I think it's a great idea!

I just signed up!

Alien Bob · 08-17-2012, 06:22 PM

Quote:

Originally Posted by dugan

Two suggestions for hosting are nearlyfreespeech.net (practically free) and OpenShift (free, and by Redhat).

Openshift site license snippet:

Quote:

Rights in Content

By displaying, publishing and making available for download and use by others any content, messages, text, files, images, photos, video, sounds, profiles, works of authorship, or any other materials ("Content") you give Red Hat a perpetual, irrevocable, worldwide, royalty-free, and non-exclusive license to reproduce, adapt, modify, translate, publish, publicly perform, publicly display and distribute any Content which you submit, post or display on or through the web site. You agree that this license includes a right for Red Hat to make such Content available to other companies, organizations or individuals with whom Red Hat has relationships for the provision of services, and to use such Content in connection with the provision of those services. You understand that Red Hat may (a) transmit or distribute your Content over various public networks and in various media; and (b) make such changes to your Content as are necessary to conform and adapt that Content to the technical requirements of connecting networks, devices, services or media. You agree that this license shall permit Red Hat to take these actions. You confirm and warrant to Red Hat that you have all the rights, power and authority necessary to grant the above license.

No can do.

Eric

kikinovak · 08-18-2012, 12:54 AM

Quote:

Originally Posted by dugan

Two suggestions for hosting are nearlyfreespeech.net (practically free) and OpenShift (free, and by Redhat).

The french site tuxfamily.org (http://www.tuxfamily.org) is an excellent solution to host free projects. I have all my SVN repos there. They've been around for more than the last ten years, and they're quite reliable.

This would be free (as in speech AND in beer) hosting.

regis rouet · 08-18-2012, 07:24 PM

Hi all

Just seen Eric's blog entry.

If the tool isn't fixed yet, you might check why and how Plone project use github for documentation.

(links to follow since this is my first post)

R.

---------- Post added 19th Aug 2012 at 02:25 ----------

http://opensourcehacker.com/2012/01/...documentation/
http://opensourcehacker.com/2012/07/...-a-year-later/

http://collective-docs.readthedocs.o...permanual.html
http://collective-docs.readthedocs.o...g/writing.html

regis rouet · 08-18-2012, 08:08 PM

Well, just had a look to readthedocs.org and Sphinx used by Plone doc.

Quite a complex stack compared to a wiki.

Maybe there are some ideas to pick, though.

manwichmakesameal · 08-18-2012, 09:40 PM

If kikinovak is indeed going to use the link that AlienBOB provided, I've started adding pages to it. We gotta start somewhere.

Phorize · 08-19-2012, 04:24 AM

Overall this is a great idea. I do a lot of policy drafting so would be very happy to do proof reading to ensure plain, logical english.

Quote:

Originally Posted by Alien Bob

It would just be hostname mapping for a server's IP address. No hosting. However, I do have taper.alienbase,nl which is a sponsored virtual server that I have full control over.

Eric

I have a bitfolk vps that is itching to do something useful. I'd be very happy to give control to a limited number of trusted admin/s. Of course control of the infrastructure can cause problems (remember when centos lost access to their sites when the admin/site owner went awol).

brianL · 08-19-2012, 07:32 AM

It's a great idea, and I would like to help. However, my technical knowledge is limited, but I may be of use for this sort of thing:

Quote:

Originally Posted by Woodsman

consider a simple check list for editorial helpers:

* Focus on basic grammar, but let people write as they are able.
* Eliminate slang and colloquialisms that non English readers likely will not understand.
* Ensure all acronyms and jargon are explained with the first usage.
* Use a "bite-size" approach: encourage contributors to use subheadings to reduce an article into smaller sections.
* The goal of an editorial review is to help the writer, not hinder or control the writer.

ruario · 08-19-2012, 07:57 AM

@brianL: You have almost 6000 posts here with almost 750 positive feedback ratings. I suspect you are more technical than you think you are. Pretty sure you could do more than just fix the English if you wanted to.

brianL · 08-19-2012, 08:02 AM

Don't let the number of posts fool you. A lot of them have been like this example.

On the ladder of linux knowledge, I'm about one-and-a-half rungs above a newbie. One foot on the ladder, the other dangling over the abyss.

ruario · 08-19-2012, 08:51 AM

Quote:

Originally Posted by brianL

Don't let the number of posts fool you. A lot of them have been like this example.

Nice post!

kikinovak · 08-19-2012, 09:00 AM

Quote:

Originally Posted by brianL

Don't let the number of posts fool you. A lot of them have been like this example.

On the ladder of linux knowledge, I'm about one-and-a-half rungs above a newbie. One foot on the ladder, the other dangling over the abyss.

Reverse Dunning-Kruger?

brianL · 08-19-2012, 09:03 AM

Quote:

Originally Posted by kikinovak

Reverse Dunning-Kruger?

Just had to look that up in wikipedia. Possibly, but unlikely.

kikinovak · 08-19-2012, 10:39 AM

Just a side note to the Slackware Documentation Team. I'll be quite busy until the first week of september with a huge job I have to finish. After that, I can devote quite some time to the wiki. Just so you won't think I'm letting you guys down in the beginning.