Wanted: Maintainer of English Puppy Manual

A home for all kinds of Puppy related projects
Message
Author
ICPUG
Posts: 1308
Joined: Mon 25 Jul 2005, 00:09
Location: UK

#21 Post by ICPUG »

puppyluvr,

The basis of a good manual is that what is written is not based on hope - but can be trusted!

Painful though it is you should check everything you write by doing what you write. Then you rewrite it to correct the errors found from the experience!

Get yourself a copy of Puppy 4.

My intention here is not to be critical but to provide advice. I know how difficult it is to devote time to writing and applaud you and craftybytes for stepping up to the plate.

ICPUG

oli
Posts: 194
Joined: Wed 30 Aug 2006, 09:04
Location: Germany, Frankfurt

#22 Post by oli »

@craftybytes: You can't open the manual in the sandbox. Either the manual is at the publish area or it is in the sandbox. And because the main chapters like how to run and install Puppy 4.0 are finished I decided to move the English manual out of the sandbox into the publish area. So everything you change is for real.

In the sandbox you can try out what you want to do with the manual. For example you can copy the html-code of the manual page and paste it into a page of the sandbox. Then you try out and when everything is alright you copy the html-code back into the manual.

@puppyluvr: Please use Puppy 4.0 when you add or edit a page to/of the Puppy 4.0 manual. There are many changes from release to release. Only if the layout (e.g. colour) is different I sometimes keep the old screenshot (because it is a question of time and importance).

User avatar
puppyluvr
Posts: 3470
Joined: Sun 06 Jan 2008, 23:14
Location: Chickasha Oklahoma
Contact:

#23 Post by puppyluvr »

:D Oli

Will upgtade my Dingo asap from 3.98 to 4.00. Been ueing 3.98 for a while, and didnt
think there was any significant difference from 4.00.
I will go thru it again in 4.00 step by step like I did in 3.98 to see if the screenshots remain the same and change any that may be different. :oops:
My intention here is not to be critical but to provide advice.
I know, and it is very much appreciated, so please DO be critical as it is important to me to do this the best that I can. :D

@ Edit. Upgraded to 4.00 and went thru the process again, but I dont see any differences from 3.98 in the screenshots, so will leave them.
All future posting will be from 4.00. Thank You.. 8)
Close the Windows, and open your eyes, to a whole new world
I am Lead Dog of the
Puppy Linux Users Group on Facebook
Join us!

Puppy since 2.15CE...

User avatar
alienjeff
Posts: 2265
Joined: Sat 08 Jul 2006, 20:19
Location: Winsted, CT - USA

#24 Post by alienjeff »

First, thank you for stepping up to the plate in this project.
puppyluvr wrote::D <snip> :D <snip> :D <snip>

suggestions are greatly appreciated

<snip> :) <snip> :oops: <snip> :roll:<snip>
Suggestion #1 - Please ease up on the emoticons. This isn't AOL ...
...so I hope they apply!!
Suggestion #2 - Don't hope. Make certain. An important key to successful editing is consistent attention to detail.
[size=84][i]hangout:[/i] ##b0rked on irc.freenode.net
[i]diversion:[/i] [url]http://alienjeff.net[/url] - visit The Fringe
[i]quote:[/i] "The foundation of authority is based upon the consent of the people." - Thomas Hooker[/size]

User avatar
HairyWill
Posts: 2928
Joined: Fri 26 May 2006, 23:29
Location: Southampton, UK

#25 Post by HairyWill »

Eagle eyed proof readers, reading the manual itself would be very helpful.
Will
contribute: [url=http://www.puppylinux.org]community website[/url], [url=http://tinyurl.com/6c3nm6]screenshots[/url], [url=http://tinyurl.com/6j2gbz]puplets[/url], [url=http://tinyurl.com/57gykn]wiki[/url], [url=http://tinyurl.com/5dgr83]rss[/url]

User avatar
puppyluvr
Posts: 3470
Joined: Sun 06 Jan 2008, 23:14
Location: Chickasha Oklahoma
Contact:

#26 Post by puppyluvr »

@alienjeff

Sorry, I didnt know the smileys were so annoying, I will attempt to refrain.
Suggestion #2 - Don't hope. Make certain.
@ I have now made certain that there are no difference`s between
3.98 and 4.00 as far as the screenshots of WLAN setup are
concerned. I had truely forgotten I was on 3.98 until I had finished
and really had to sleep, so I figured I`d D/L 4.00 and check the next
morning, which I did.
@ Of course Ive read the 4.00 manual, (translated from German),
hence my choice of a section that was unfinished in either language
while using the 3.01 and 4.00 manuals as stylistic reference, to
(hopefully) maintain consistency, for the ease of the end user..

@ Well, I did ask for criticism, didnt I ?? Keep it up!! I just want to do the best job
I can, for the benefit of the end user, and for Puppy...
Last edited by puppyluvr on Thu 19 Jun 2008, 06:03, edited 1 time in total.
Close the Windows, and open your eyes, to a whole new world
I am Lead Dog of the
Puppy Linux Users Group on Facebook
Join us!

Puppy since 2.15CE...

User avatar
craftybytes
Posts: 298
Joined: Fri 17 Nov 2006, 10:32
Location: QLD AUSTRALIA

#27 Post by craftybytes »

@HairyWill -
Eagle eyed proof readers, reading the manual itself would be very helpful.
Yep - that is what I'm doing to start with - giving the whole Manual the once over to see if there is any spelling or mistranslations that need fixing - then I'll get more daring and try my hand with one or two of the sections that maybe need more elaboration for clarity..

Hopefully in my stumbles through the editing mash I don't misconstrue the concepts behind the use of Puppy and write something incorrectly or out of context..

Anyway I'm just happy to give something back to Puppy..

crafty.
.
3 x boot:- ASROCK VIA 'all-in-one' m/b; AMD Duron 1.8Ghz+; 1.0GB RAM; 20GB hdd (WinXP Pro); 80GB hdd (MEPIS 3.4-3/Puppy v2.15CE Frugal); 1GB USB pendrive (Puppy 2.15CE Frugal); CD/DVDRW; 17" LCD monitor; HSF 56k modem... MEPIS is great.. Puppy ROCKS..

User avatar
HairyWill
Posts: 2928
Joined: Fri 26 May 2006, 23:29
Location: Southampton, UK

Re: Reporting for duty

#28 Post by HairyWill »

alexthedragon wrote:I will be happy to help with the English manual and I might even get the time to do a Danish one, though I might need a extra pair of hands for that one.
@Alex,
Sorry it has taken a couple of days to reply to this, your offer has forced us to think quite carefully about how things are organised.

The short response is that puppyluvr and craftybytes would be happy to have you work with them on the manual and I will change the status of your account on puppylinux.org. Welcome aboard.

Because you have not previously had a presence in the puppy community I am sure you can appreciate that there was a trust issue involved in granting you access to edit. This has forced the site admins to carefully consider how we can best facilitate contributions.

@all editors/translators
As the manual is in wiki format the role translator now has very similar rights to that of any registered user except that ordinary users cannot modify the manual. The revision tab should allow translators to revert back to earlier versions of a page and page deletion rights have been removed so it should now be impossible for a translator to irrevocably delete someone else's work. (If you find a way to do so, please let Tom know so that it can be tightened up). Hopefully the guaranteed ability to revert is more valuable than the ability to delete. Should you need to delete a page then please ask an admin, (raffy, hairywill, WhoDo, tombh, lobster, oli, prit)

I have also created a page which displays recent manual edits
http://www.puppylinux.org/manual_recentness
this also has an rss feed associated with it
http://www.puppylinux.org/manual_recentness/feed

any problems, please shout
Will
contribute: [url=http://www.puppylinux.org]community website[/url], [url=http://tinyurl.com/6c3nm6]screenshots[/url], [url=http://tinyurl.com/6j2gbz]puplets[/url], [url=http://tinyurl.com/57gykn]wiki[/url], [url=http://tinyurl.com/5dgr83]rss[/url]

User avatar
craftybytes
Posts: 298
Joined: Fri 17 Nov 2006, 10:32
Location: QLD AUSTRALIA

#29 Post by craftybytes »

Thanks Will..

Now that that has been sorted - I think it be time for us new 'maintainers/translators' to now get together and discuss our personal approaches and our perceived priorities towards editing the Manual - more for coordination purposes..

Should this be done in this particular thread or should we open a new topic to follow through..?

And if a new topic - still in this forum or in the sub-forum "Documentation Project" - as any ongoing queries / discussions are related to the Manual (thus 'documentation')..?

TIA.

crafty.
.
3 x boot:- ASROCK VIA 'all-in-one' m/b; AMD Duron 1.8Ghz+; 1.0GB RAM; 20GB hdd (WinXP Pro); 80GB hdd (MEPIS 3.4-3/Puppy v2.15CE Frugal); 1GB USB pendrive (Puppy 2.15CE Frugal); CD/DVDRW; 17" LCD monitor; HSF 56k modem... MEPIS is great.. Puppy ROCKS..

User avatar
puppyluvr
Posts: 3470
Joined: Sun 06 Jan 2008, 23:14
Location: Chickasha Oklahoma
Contact:

#30 Post by puppyluvr »

Hello,
@ When I go to the site and log in all is well. But if I go to the "Manual" tab it automatically logs me out. If I re-log-in again it navigates me away from the manual page, and when I attempt to return to the manual it logs me out again!! The wiki page..ect..doesnt do this, just the manual page.The edit button is there, but I cannot
input text as it says im not logged in. Have I been revoked???
Too many smileys in my posts perhaps????LOL

@
Now that that has been sorted - I think it be time for us new 'maintainers/translators' to now get together and discuss our personal approaches and our perceived priorities towards editing the Manual - more for coordination purposes..

I agree Crafty, do you use Gizmo??? A great way for us all to "chat together"

@Oli, I notice missing pages in the 301 manual, are we also free to add to/edit
the 301 manual as well???
Close the Windows, and open your eyes, to a whole new world
I am Lead Dog of the
Puppy Linux Users Group on Facebook
Join us!

Puppy since 2.15CE...

User avatar
Lobster
Official Crustacean
Posts: 15522
Joined: Wed 04 May 2005, 06:06
Location: Paradox Realm
Contact:

#31 Post by Lobster »

Have I been revoked???
We had an informal admin meeting yesterday using Skype
HairyWill made a vey good point:

Translators and editors have to be protected - from themselves . . . it ensures that they avoid the embarrassment of deleting work or otherwise experimenting too enthusiastically.

Tom and Hairy are therefore in the process of invoking your participation . . .
Tom is available on Skype (as I believe you are - or are you on Gizmo - that is it - they are both on Gizmo too)
Both Tom and Hairy are very amenable if you wish to contact them with any questions
Puppy Raspup 8.2Final 8)
Puppy Links Page http://www.smokey01.com/bruceb/puppy.html :D

User avatar
Billwho?
Posts: 559
Joined: Tue 06 Dec 2005, 09:28
Location: still "In The Dog House" East Coast Oz
Trialing 4.20

#32 Post by Billwho? »

Hi All
It seems that there are now plenty of translators and editors available for the Puppy 4 manual. But as I have been proof-reading the earlier English manuals for Oli I will keep poking around in them if nobody minds. If you add any new chapters to the earlier manuals send me a PM and I will run a second eye over them for you. Likewise if for some reason you would like me to have a look at the latest manual just send me a PM.

@Will. I do still have editor access don't I? (Haven't had to change much lately :) )
Linux = Learning through doing :shock: :? :D
The learning curve may be steep but there is a light at the end of the tunnel.
You just have to pass the occasional oncoming train to get there.

User avatar
HairyWill
Posts: 2928
Joined: Fri 26 May 2006, 23:29
Location: Southampton, UK

#33 Post by HairyWill »

@puppyluvr
I just logged in as an ordinary user and was able to view the manual fine.
I wonder if Tom screwed down the translator permissions a bit too tight yesterday. I've had a quick look and I can't see anything obvious.

@billwho
just try it
Will
contribute: [url=http://www.puppylinux.org]community website[/url], [url=http://tinyurl.com/6c3nm6]screenshots[/url], [url=http://tinyurl.com/6j2gbz]puplets[/url], [url=http://tinyurl.com/57gykn]wiki[/url], [url=http://tinyurl.com/5dgr83]rss[/url]

User avatar
puppyluvr
Posts: 3470
Joined: Sun 06 Jan 2008, 23:14
Location: Chickasha Oklahoma
Contact:

#34 Post by puppyluvr »

@
» Access Denied
You are not authorized to access this page.
:( :cry:

User avatar
tombh
Posts: 422
Joined: Fri 12 Jan 2007, 12:27
Location: Bristol, UK
Contact:

#35 Post by tombh »

@puppyluvr: I'm pretty sure that's a cache problem. Try hard-refreshing with CTRL+F5 maybe, or clearing your browsers cache.
[url=http://www.tombh.co.uk/colour_memories/contribute.php]Colour-Memories Database[/url]

User avatar
puppyluvr
Posts: 3470
Joined: Sun 06 Jan 2008, 23:14
Location: Chickasha Oklahoma
Contact:

#36 Post by puppyluvr »

@Tombh,
Cleared browser cache. now i can view the manual and remain logged in, however the edit function seems to be missing. I have View / Review but no edit..

@thanks for the ctrl/F5 trick!!!

User avatar
davidA
Posts: 64
Joined: Sun 15 Jun 2008, 04:55
Location: Location: Location:

#37 Post by davidA »

Hello everyone:

Here is a suggestion (from a new user perspective) that for reasons I am not aware of, may not be possible to put in place - regarding the ongoing maintenance of the manual:

It seems to me (that if many people will be working on maintaining it) that it would be wise for only one person to move (and review) the final edit (from the place where it is edited) to its final destination. This will protect the original copy from being accidentally damaged.

I am suggesting that the manual be developed in a different work area.

There are some very useful tools that allow a group of people to work together on projects, to easily make rollbacks, to do diffs, to compare with what has been written before.

One such (very simple) tool is.

http://www.usemod.com/cgi-bin/wiki.pl Likely there are many similar ones; there may even be a tool in the existing Wiki, where this can be accomplished.

David

User avatar
tombh
Posts: 422
Joined: Fri 12 Jan 2007, 12:27
Location: Bristol, UK
Contact:

#38 Post by tombh »

@puppyluvr: just havin me dinner, so didn't have much time to check thwat out, but made one little change. Does it work now?
[url=http://www.tombh.co.uk/colour_memories/contribute.php]Colour-Memories Database[/url]

User avatar
alexthedragon
Posts: 3
Joined: Tue 17 Jun 2008, 09:35
Location: Denmark
Contact:

Re: Reporting for duty

#39 Post by alexthedragon »

Thank you HairyWill, I believe you are right to act with caution, it is after all just common sense. In time I am sure I will earn everyones trust. ;-)

Thank you for the new status, now I just need to learn the ropes and were in business.

User avatar
puppyluvr
Posts: 3470
Joined: Sun 06 Jan 2008, 23:14
Location: Chickasha Oklahoma
Contact:

#40 Post by puppyluvr »

:D Hello Tombh,

Now I can edit the title of a page, but not the body!!!! Only the title is highlighted for editing!!! :D
Sorry... :(
Close the Windows, and open your eyes, to a whole new world
I am Lead Dog of the
Puppy Linux Users Group on Facebook
Join us!

Puppy since 2.15CE...

Post Reply