Puppy Linux Discussion Forum Forum Index Puppy Linux Discussion Forum
Puppy HOME page : puppylinux.com
"THE" alternative forum : puppylinux.info
 
 FAQFAQ   SearchSearch   MemberlistMemberlist   UsergroupsUsergroups   RegisterRegister 
 ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 

The time now is Thu 23 Oct 2014, 18:12
All times are UTC - 4
 Forum index » Advanced Topics » Puppy Projects » Documentation Project
Welcome
Moderators: Flash, JohnMurga, puppian
Post new topic   Reply to topic View previous topic :: View next topic
Page 1 of 1 [7 Posts]  
Author Message
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Sat 19 Nov 2005, 02:15    Post subject:  Welcome  

Welcome!

So happy to meet everyone here Cool
We'll be discussing everything about puppy docs Very Happy

Some general info:

Please add your docs to http://puppylinux.org/docs/pre
Just click the Login link (see left column) to start editing. Password: pldp
You can use this sandbox page to practice your editing skills.

When the documentation is almost finished the whole site will be moved to http://puppylinux.org/docs and continue to be maintained by the documentation committee.


To create a new page, just edit any existing page and add the name of your new page at the end. Then, highlight that newly added line and click the H1 button (for sub-menu click H2 or H3). Finally click the 'save' button (the floppy icon) and the link to your new page will appear in the left pane. Multiple pages can be created at one time using this method. To delete a page, edit it and delete everything in it, then click 'save'. Must read:
User's Manual
Creating your pages
How to do common task
Writing your first pages



And here's the tree structure.

Btw please use this template to write your page Smile
http://puppylinux.org/docs/pre/?TEMPLATE

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005

Last edited by puppian on Thu 08 Dec 2005, 14:13; edited 1 time in total
Back to top
View user's profile Send private message Visit poster's website 
raffy

Joined: 25 May 2005
Posts: 4779
Location: Manila

PostPosted: Sun 20 Nov 2005, 19:50    Post subject: Great!  

Great work, Puppian! As soon as the CMS decision is taken, we can also begin testing the installation.

(Note: "we" is a way of speaking - it means "you with some help from us" Smile )
Back to top
View user's profile Send private message 
J_Rey


Joined: 04 May 2005
Posts: 276
Location: Northwest Florida, U.S.A.

PostPosted: Mon 28 Nov 2005, 00:11    Post subject:  

Well, it looks like now we're contributing to http://puppylinux.org/docs/ instead of using the preview site. Confused
Back to top
View user's profile Send private message Visit poster's website AIM Address Yahoo Messenger 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Mon 28 Nov 2005, 11:22    Post subject:  

Below is the understanding so far. Hope it helps Smile

Quote:

As to the link to /docs, it seems that the way cmsimple manage docs is more flexible and easy to navigate. Everything is in one large file which can be downloaded for offline viewing and can be converted to pdf file easily. So we can have it there for people to who want to view html online, and when the docs are almost finished, we can also convert it to pdf, and put a link in the 'Downloads' section for people to download it (just like what the php-fusion website did themselves), and could have version updates too (e.g. docsPuppy105.pdf, docsPuppy109.pdf, etc). This way different people who prefer different formats would be happy Smile

The 'Articles' section at /docs/pup can be kept simple, mainly for stuff like handbook, mini-howto and quick guides Smile So cmsimple would be for official stable docs only, while php-fusion will have everything else Smile (btw will try to make the cmsimple theme looks more like the php-fusion one)

In fact some other linux distros are using standards like docbook xml to manage their docs (which are more complex and takes much more time to manage), but as our docs project is just a start (still an infant Wink ), I guess it's best to keep it simple now.


So just continue your initial writings for pldp at http://puppylinux.org/docs/pre , and when the docs are almost finished they will be moved to http://puppylinux.org/docs/ Smile

PS. raffy has done some really great editing to /docs/pup, take a look!

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
Back to top
View user's profile Send private message Visit poster's website 
mayakovski


Joined: 19 Nov 2005
Posts: 124
Location: Comox, BC, CANADA

PostPosted: Tue 29 Nov 2005, 13:51    Post subject:  

Ok, so can someone provide a diffinative answer.

Are we using /docs or /docs/pre?

I personally think it makes sense to use /docs and just work there in the main area. That way it is more incentive to be quick, efficient and accurate. But I will take my ques from you folks who are by far the more senior puppies.

Me, I'm just a baby puppy. Smile

_________________
Mayakovski
**********************
Puppy Linux | Barking Up The Right Tree

Compaq Armada 1580DMT | P150, 49MB RAM - 3.2 GB HD, Puppy 1.0.6
Compaq Deskpro EN | P3-733, 384 MB RAM - 80GB HD, Puppy 1.0.7
Back to top
View user's profile Send private message 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Tue 29 Nov 2005, 14:08    Post subject:  

Maybe I should have written it this way Smile

So just continue your initial writings for pldp at http://puppylinux.org/docs/pre, and finished pages will be moved to http://puppylinux.org/docs/

docs/pre is used for initial writings, for example, sometimes I can't finish a whole page, but just half of it, and it's better to leave it at docs/pre, so our new puppy user won't see a halfly finished page (which may also contain incorrect information since proofreading hasn't been done yet) Smile
Also, docs/pre is accessible by everyone and so we can have contributions from different people, which can be then proofread by the docs committee Smile

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
Back to top
View user's profile Send private message Visit poster's website 
mayakovski


Joined: 19 Nov 2005
Posts: 124
Location: Comox, BC, CANADA

PostPosted: Tue 29 Nov 2005, 14:40    Post subject:  

Thanks Puppian;

That makes it very clear to me, it makes sense too.

_________________
Mayakovski
**********************
Puppy Linux | Barking Up The Right Tree

Compaq Armada 1580DMT | P150, 49MB RAM - 3.2 GB HD, Puppy 1.0.6
Compaq Deskpro EN | P3-733, 384 MB RAM - 80GB HD, Puppy 1.0.7
Back to top
View user's profile Send private message 
Display posts from previous:   Sort by:   
Page 1 of 1 [7 Posts]  
Post new topic   Reply to topic View previous topic :: View next topic
 Forum index » Advanced Topics » Puppy Projects » Documentation Project
Jump to:  

You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum
You cannot attach files in this forum
You can download files in this forum


Powered by phpBB © 2001, 2005 phpBB Group
[ Time: 0.0662s ][ Queries: 12 (0.0108s) ][ GZIP on ]