see level 3 guys
Posted: Sun 31 Aug 2008, 08:46
There is a T2 discussion recently started by Barry, so you will find all true developers there (level 3 up): http://murga-linux.com/puppy/viewtopic.php?t=32972
READ-ONLY Archive
https://oldforum.puppylinux.com/
Excellent. If you're serious, The Wiki would be an excellent contribution to this project as it stands at the moment. It needs refinement for your reasoning reguarding new users.jhecht wrote:John Hechtman - contact through forum, or direct email.
I'd like to make the following a steadfast rule for all Puppy documentation; when you describe a process, ALWAYS give EVERY step! Every single mother-lovin' one of them, no matter how obvious, or self-evident you think they are. What is self-evident to YOU may NOT be to the next person to read the docs...
If you don't want to spell out a procedure in your docs, you MUST provide a link to it, so someone who does not know that step can find the missing puzzle piece, and then come back to your docs quickly...
If everyone who works on Puppy documentation abides by this simple, logical rule Puppy documentation will very soon outshine the docs for almost any other available distro!
Thanks!
or another idea is,,, Muggins posted a little program that can record your screen as you do things, If someone would say record how to make a pet package, you could translate that video into text format, and maybe pause it and take screen shots and then we'll have a real nice documentation. How does that sound?jhecht wrote:John Hechtman - contact through forum, or direct email.
I'd call myself sort of a level 2. I've used Puppy for a long time, along with other Linux distros. I'm a pro computer tech by trade, and service both Windows and Macintosh 'puters.
Not a programmer, not a developer, but what I AM is a very skilled technical writer. Just had a book published on wiring audio recording studios. Check out: http://www.amazon.com/Audio-Wiring-Guid ... 0240520068
So I'd like to volunteer to help with documentation. One of the biggest stumbling blocks for all the Linux distros I've worked with (maybe 12-15) is that they either have almost no documentation, or really scanty documentation, or else the docs presuppose a level of knowledge and expertise that may/may not exist in a new - or even intermediate - end user.
I'd like to make the following a steadfast rule for all Puppy documentation; when you describe a process, ALWAYS give EVERY step! Every single mother-lovin' one of them, no matter how obvious, or self-evident you think they are. What is self-evident to YOU may NOT be to the next person to read the docs...
If you don't want to spell out a procedure in your docs, you MUST provide a link to it, so someone who does not know that step can find the missing puzzle piece, and then come back to your docs quickly...
If everyone who works on Puppy documentation abides by this simple, logical rule Puppy documentation will very soon outshine the docs for almost any other available distro!
I cam be reached at jhecht@ix.netcom.com
Thanks!
MM - it's a lovely idea, but I fear you are asking me to commit to more time than I can give - and also more expertise - I have never edited a Wiki...mysticmarks wrote:Excellent. If you're serious, The Wiki would be an excellent contribution to this project as it stands at the moment. It needs refinement for your reasoning reguarding new users.jhecht wrote:John Hechtman - contact through forum, or direct email.
I'd like to make the following a steadfast rule for all Puppy documentation; when you describe a process, ALWAYS give EVERY step! Every single mother-lovin' one of them, no matter how obvious, or self-evident you think they are. What is self-evident to YOU may NOT be to the next person to read the docs...
If you don't want to spell out a procedure in your docs, you MUST provide a link to it, so someone who does not know that step can find the missing puzzle piece, and then come back to your docs quickly...
If everyone who works on Puppy documentation abides by this simple, logical rule Puppy documentation will very soon outshine the docs for almost any other available distro!
Thanks!
I would also like to know if you would be able to correlate with a level 3 to produce a cloud diagram of the squash file system overlay of puppy with links to the updated wiki [which of course you having redesigned sorted/created the appropriate documentation for. ].
Ideally, a new start page for puppy that will be an attractive/interactive diagram of a layered union file system and linked to man pages essentially providing lesson 1 for the new user, and allowing them access to level 2 very quickly. This is essential in maintaining a user base.
It would be a big undertaking, but would correct some long standing side work that has become a stone in the shoe.
Would you please provide a link for the program Muggins uploaded? It sounds very useful!ttuuxxx wrote: or another idea is,,, Muggins posted a little program that can record your screen as you do things, If someone would say record how to make a pet package, you could translate that video into text format, and maybe pause it and take screen shots and then we'll have a real nice documentation. How does that sound?
Not really implying that it has to be you, just an idea, to simplify things, some people have problems putting actions into words, Ever see the movie "Lost in Translation?" great movie
ttuuxxx
Aitch - please read my reply at:Aitch wrote:jhecht
John, 1st I support your comment to ttuuxxx about the links, so also have to admit not being so supportive of your links in your posts, which I feel are a bit spammy for a forum
However, I know you are trying to grow you're business, I just feel there are better ways, OK
Link here:-
http://www.murga-linux.com/puppy/viewtopic.php?t=33674
As you will see, you got some support
I've sent you a pm with some ideas re this, HTH
Aitch