12 Replies Latest reply on Oct 22, 2002 9:08 PM by schaefera

    Modify Quick start?

    siegfried1

      I've learned a few things from these forums that I find other folks asking about.

      May I modifiy the quickstart guide with this information?

      Siegfried

        • 1. Re: Modify Quick start?
          tdang

          Why not? Every help is very welcomed.

          Regards.

          • 2. Re: Modify Quick start?
            schaefera

            Of course you can but because they are word documents the are some rules:
            - checkout the word documents from CVS
            - open them and go to "tools->track changes->highlight changes" and make sure that this checkbox is checked
            - make your changes
            - send the changed document to me (andreas@jboss.org)

            Otherwise you could loose your work when you just upload your changed word document directly.

            Have fun - Andy

            • 3. Re: Modify Quick start?
              siegfried1

              Andy,
              I'm sorry, I think I need more explicit instructions. Tools? I have downloaded a copy of CVS.

              I assume I start CVS and then somehow point it to jboss.org?

              Siegfried

              • 4. Re: Modify Quick start?
                tdang

                Hi Andy,

                What are you going to modify? I want to do it, too. I do not want to do the same if you have already done.

                Regards.

                • 5. Re: Modify Quick start?
                  siegfried1

                  I wanted to put in better directions for running the samples such as

                  (1) How to look at your tables in hypersonic
                  (2) How to run the clients (cmp2 requires you say "ant setup")
                  (3) I anted to emphasize that all the samples use the default deploy directory and not the "all" deploy directory.
                  (4) I wanted to emphasize some things that could go wrong.

                  • 6. Re: Modify Quick start?
                    siegfried1

                    Andy, where are you? We need you...

                    • 7. Re: Modify Quick start?
                      schaefera

                      Hi

                      You can reach me under andreas@jboss.org if it is important.

                      To change the Word document please
                      - open it with M$ Word
                      - go to the Menu
                      - open "Tools"
                      - click on "Track Changes"
                      (if you use Word 97 you must make sure that Highlight Changes is selected)

                      Now any changes on the document has another color and is underlined.

                      THEN SEND ME THE document and I review the changes and incorporate the changes if necessary.

                      Have fun - Andy

                      • 8. Re: Modify Quick start?
                        schaefera

                        Currently I am changing Chapter 2 and 3 to improve the wording.

                        Andy

                        • 9. Re: Modify Quick start?
                          alwyn

                          Hmmm,

                          Has anyone ever thought of making the documents like the
                          quick start guide web based? I'm thinking in line with how the php documentation is on php.net? Maybe not only limited to comments...

                          From the pictures on jboss.org I suspected that many of the developers are advanced in certain academic areas. This would suggest that their preferred documentation format would be tex. Must have guessed wrong. Anyway, why not use a base format which anybody with a text editor can process?

                          • 10. Re: Modify Quick start?
                            alwyn

                            Hmmm,

                            Has anyone ever thought of making the documents like the
                            quick start guide web based? I'm thinking in line with how the php documentation is on php.net? Maybe not only limited to comments...

                            From the pictures on jboss.org I suspected that many of the developers are advanced in certain academic areas. This would suggest that their preferred documentation format would be tex. Must have guessed wrong. Anyway, why not use a base format which anybody with a text editor can process?

                            • 11. Re: Modify Quick start?
                              siegfried1

                              alwyn: You can convert it. Actually, I was thinking of converting it to XML for use with FOP in my copious spare time.

                              Andy,
                              Where do I get the word version? I only know how to get the PDF version! I assume the original is kept in CVS. Can you tell me how to use CVS to get it?

                              Thanks,
                              Sieg

                              • 12. Re: Modify Quick start?
                                schaefera

                                Hi

                                CVS Module "manual" and then under "src/guide".

                                Have fun - Andy