Hi Stuart, I have just started going through the
http://www.4p8.com/eric.brasseur/flight_simulator_tutorial.html document and it is brilliant. I am beginning to understand the complexities of flight. It is really a brilliantly written document and would really add weight to the current manuals that are packaged along with FG. Regards, Venkat Buchanan, Stuart wrote: > --- Venkatesh Parthasarathy wrote: > >> Hello Stuart, >> >> Thank you for your quick and detailed reply, and please call me Venkat. >> > > Hi Venkat, > > >> I have FG installed at home for the last 2 weeks and use it regularly. >> However, I find the manual installed with the package is aimed at users >> with a little background in Aviation. I do not have that background and >> find the manual difficult to use. Simple tasks such as taxiing, taking >> off, cannot be performed by a first timer with the information provided >> in the manual, and I am struggling even to taxi let alone takeoff and >> maintain the altitude. >> > > I think I may mis-read your original email - my apologies. > > >> I know that the whole effort of writing is entirely voluntary and I am >> grateful for that and appreciate that the author has made the effort to >> do the documentation. In fact, I would be very happy to help in this >> regard. >> > > Your help would be very welcome. I think that good documentation is what > distinguishes a mature product/project from one that is still in early > stages of development. > > >> I have not had the opportunity to go through >> >> http://www.4p8.com/eric.brasseur/flight_simulator_tutorial.html >> >> yet. >> > > I think you will find that tutorial very helpful. It also references > additional material. > > >> Would it be possible for creating and maintaining different documents >> targeting different audience levels? And how can I help? >> > > As you've (intentionally?) highlighted, the challenge is _maintaining_ the > different documents. Over time, documentation goes out of date, and we > currently have enough trouble just keeping The Manual current - and that > is with 2 or 3 active maintainers. Other documents tend to be the product > of one person, who in the future may no-longer have enough time to keep > them up to date. > > I think The Manual can be sufficiently flexible to be useful to both an > experienced pilot/simulator and someone completely new. > > IMHO answer is providing a main body that concentrates on FG itself > (running the program, using the features), and a series of tutorials that > concentrate on simulating simple lessons - a FG Flight-school. Once Eric's > tutorial has been added, we will have much more coverage in this area. > > BTW, if you start with the c172p, the Help menu includes a Tutorial option > that includes a couple of interactive lessons on flying - you may find > them useful. > > -Stuart > > PS: Apologies for the previous top-post. > > >> Buchanan, Stuart wrote: >> >>> Hi Venkatesh Parthasarathy, >>> >>> You will probably want to start by having a look at the documentation >>> >> we >> >>> already have. See http://www.flightgear.org/docs.html. >>> >>> The main piece of documentation is The FlightGear Manual (aka The >>> >> Manual). >> >>> This is delivered with each release and is intended to be complete >>> >> user >> >>> documentation. >>> >>> We also have an active Wiki, which contains information that hasn't >>> >> been >> >>> added to The Manual (yet). >>> >>> I would suggest that you download FG, and have a play with it while >>> referencing the Manual and Eric's tutorial >>> (http://www.4p8.com/eric.brasseur/flight_simulator_tutorial.html). We >>> >> are >> >>> currently merging this tutorial into the Manual. >>> >>> Once you've done this you should have >>> a) an idea of where the documentation needs improving >>> b) a better idea of how FG works. >>> >>> I'd highly recommend that you look at improving The Manual as opposed >>> >> to >> >>> writing completely new documentation. It is typset using Latex and is >>> under CVS source-code control. If you are not familiar with either of >>> these tools, don't worry - they are pretty easy to learn and provide a >>> very easy way for multiple people to work on the same document. >>> >>> Hope this helps. >>> >>> -Stuart >>> >>> --- Venkatesh Parthasarathy wrote: >>> >>> >>> >>>> Hello Everyone, >>>> >>>> I am a Tech Writer by profession and would like to pitch in to write >>>> >> the >> >>>> FG documentation. However, I have a major drawback, I do not have any >>>> >>>> background in aviation / simulation. Where would I get enough >>>> >> background >> >>>> or basic information about aviation before I can commit myself to >>>> >> this >> >>>> task. >>>> >>>> Any links to documents that would provide basic knowledge would be >>>> welcome. >>>> >>>> Regards, >>>> Venkatesh Parthasarathy, >>>> India. >>>> >>>> >>>> >>>> > ------------------------------------------------------------------------- > >>> >>> >>>> Using Tomcat but need to do more? Need to support web services, >>>> security? >>>> Get stuff done quickly with pre-integrated technology to make your >>>> >> job >> >>>> easier >>>> Download IBM WebSphere Application Server v.1.0.1 based on Apache >>>> Geronimo >>>> >>>> >> http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 >> >>>> _______________________________________________ >>>> Flightgear-users mailing list >>>> Flightgear-users@lists.sourceforge.net >>>> https://lists.sourceforge.net/lists/listinfo/flightgear-users >>>> >>>> >>>> >>> >>> >>> ___________________________________________________________ >>> Inbox full of spam? Get leading spam protection and 1GB storage with >>> >> All New Yahoo! Mail. http://uk.docs.yahoo.com/nowyoucan.html >> >>> > ------------------------------------------------------------------------- > >>> Using Tomcat but need to do more? Need to support web services, >>> >> security? >> >>> Get stuff done quickly with pre-integrated technology to make your job >>> >> easier >> >>> Download IBM WebSphere Application Server v.1.0.1 based on Apache >>> >> Geronimo >> >> http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 >> >>> _______________________________________________ >>> Flightgear-users mailing list >>> Flightgear-users@lists.sourceforge.net >>> https://lists.sourceforge.net/lists/listinfo/flightgear-users >>> >>> >>> >> >> > ------------------------------------------------------------------------- > >> Using Tomcat but need to do more? Need to support web services, >> security? >> Get stuff done quickly with pre-integrated technology to make your job >> easier >> Download IBM WebSphere Application Server v.1.0.1 based on Apache >> Geronimo >> http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 >> _______________________________________________ >> Flightgear-users mailing list >> Flightgear-users@lists.sourceforge.net >> https://lists.sourceforge.net/lists/listinfo/flightgear-users >> >> > > > > > ___________________________________________________________ > The all-new Yahoo! Mail goes wherever you go - free your email address from > your Internet provider. http://uk.docs.yahoo.com/nowyoucan.html > > ------------------------------------------------------------------------- > Using Tomcat but need to do more? Need to support web services, security? > Get stuff done quickly with pre-integrated technology to make your job easier > Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo > http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 > _______________________________________________ > Flightgear-users mailing list > Flightgear-users@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/flightgear-users > > ------------------------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ Flightgear-users mailing list Flightgear-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/flightgear-users
