I can never get my head around a new application without staring at a printed page to use alongside the keyboard.
So I copied all the current docs (2007/01/02) and put them/it into a PDF file, zipped over to Kinkos and bam! - printed double sided and neatly coil bound.
If you feel the same - enjoy.
Whoops! Sorry the PDF is too big to upload (Ryan is going to do that) but here is the OpenOffice file I used to make the PDF.
(Factoid: Did you know that OpenOffice Writer will make PDF files from almost any kind of document? That beats paying Adobe many $$$ for Acrobat.)
Cheers,
HalD
"Today’s headlines are nothing more than whispers of history"
-
MODX Staff
- 12,272 Posts
Thanks to Acrobat Pro, I’ve compressed a version and attached it to your original post. Thanks for doing this!
Ryan Thrash, MODX Co-Founder
Follow me on Twitter at @rthrash or catch my occasional unofficial thoughts at thrash.me
"He can have a lollipop any time he wants to. That's what it means to be a programmer."
Thanks All for the comments. I know Acrobat will create a smaller file than OO Write - it’s just that I don’t have the $299.00 for it when OO Writer is Free $00.00.
In reading over the printed Documents - I began to see how mixed up and confusing it is (I apologize ahead of time for ’stepped upon toes’.)
with duplicate material in different sections that do not quite match in meaning, explanations that don’t explain and so on. When I was in the military the mantra for anyone complaining or pointing out a problem was/is "So what is your solution? Don’t bring me problems without solutions!" Therefore - I am retired and have the time, - I am willing to work on getting the Documentation in shape - with plenty of help from the original authors. So bring it on.
Cheers
Hald
"Today’s headlines are nothing more than whispers of history"
Just a quick pointer - Adobe Reader 8 introduces (finally) Booklet Printing. If you have a duplex printer, this is really neat because it reduces pages down and rearranges the pages so that they are in the right order for when you fold the sheets in half. If you have to print one side and then the other, it’s still fairly easy.
And indeed, the main problem with the current documentation is that it is lots of bits of useful information that just fall short of a coherent and complete whole - which is highlighted by this useful and commendable attempt to group it together.
I think the best plan for a collected documentation would be:
1) Add missing pages to wiki.
2) Update wiki.
3) Copy most important pages from wiki into word processor.
4) Arrange into some sensible order (possibly the hardest part).
5) Edit down to remove duplication (anything said twice is ditched the second time if it isn’t needed).
6) Publish.
After a year again i came back to this topic, While reading i was thinking of a book about nearly everything in MODx, Is it too early for that?!, So... Anyone interested in cooperation to write a book about MODx ?, I think it is done in Japanese! but how about English?, I know that i can adjust the publisher for this but is there anyone in a writing for MODx mood?