• Which the release of FS2020 we see an explosition of activity on the forun and of course we are very happy to see this. But having all questions about FS2020 in one forum becomes a bit messy. So therefore we would like to ask you all to use the following guidelines when posting your questions:

    • Tag FS2020 specific questions with the MSFS2020 tag.
    • Questions about making 3D assets can be posted in the 3D asset design forum. Either post them in the subforum of the modelling tool you use or in the general forum if they are general.
    • Questions about aircraft design can be posted in the Aircraft design forum
    • Questions about airport design can be posted in the FS2020 airport design forum. Once airport development tools have been updated for FS2020 you can post tool speciifc questions in the subforums of those tools as well of course.
    • Questions about terrain design can be posted in the FS2020 terrain design forum.
    • Questions about SimConnect can be posted in the SimConnect forum.

    Any other question that is not specific to an aspect of development or tool can be posted in the General chat forum.

    By following these guidelines we make sure that the forums remain easy to read for everybody and also that the right people can find your post to answer it.

ADE Version 1.70 Documentation

Messages
9,030
Country
us-illinois
Hi Jon:

Just to clarify, after installation, the ADE_v170 "ReadMe's" are in:

[Airport Design Editor 170 install path]\Manuals folder


But, to get the currently available version of a "ADE full manual" (aka "ADE User Guide"), one must manually download it via the link in this post:

http://www.fsdeveloper.com/forum/threads/ade-version-1-65-english-manual-released.433288/


BTW: Could ADE offer an option to make the ADE "User Guide" (PDF or a HTML / CHM version) load via the ADE > Help pull-down menu ? :scratchch


Perhaps also, the ADE Help pull-down menu could be configured to automatically scan the:

[Airport Design Editor 170 install path]\Manuals folder


...and add links in the ADE Help pull-down menu whenever ADE starts up, as any new or replacement ReadMe's and PDF's / or HTML / CHM versions are added to that folder with various ADE / GP Editor updates etc. ? :idea:


Thanks in advance for your consideration of this ADE feature enhancement. :)

GaryGB
 
Last edited:
That is an interesting idea Gary - thanks for that :) Let me take a look.
 
Gary, I concur, but it gets me confused still more.
Your link points to a manual (there Helli did a very fine job) of February 2015 while I have one here that says (but the same one if I am not mistaken):
ADE manuals.jpg


Now which is what and where is the one that gives me the latest information?
Rest assured, everything works fine now (as it did before) but I am just wanting to point out the difficulties for a newbie to get up to date as I am forced to start believing I am a newbie as well (which I am probably am compared to many others on this site):eek:.
Once again sorry, Jon, to test your patience:rolleyes:.
 
I have moved this out of the general thread so that we are not discussing several different things at one - confuses me.

I actually agree about the documentation. Helli wrote the last full manual in 2015 and to be honest I do not think there will be another rewrite or new stuff added to it. Helli may be willing but I am thinking about the future here. We have a good solid manual for 1.65. My intention was to supplement this as we go forward. My preferred method is to use the on-line help that I have been slowly adding to over the past year or so.

My proposal is to eliminate all the odds and ends of pdf documentation that is not in the main manual and move them all to the on-line help. I put my hands up that I have not carefully looked at the manuals folder recently and it probably contains some out of date junk.

So the proposal is to freeze the main manual as it is, remove all the other odds and ends and move the information to the on-line system - which is by the way accessible from the ADE help menu - and add any further documentation there.
 
Yes, Jon, that would be the best idea: do not include anymore manuals in the download but move them (as you said) to the on-line help (FSDeveloper or where?).
Beware though that your program in the meantime contains so many new features that you may be rather more busy still on the on-line help:).

PS (so that you know it is me): I will be back once I contacted the newbies and see what they have to say because we are biased!
 
Gary, I concur, but it gets me confused still more.
Your link points to a manual (there Helli did a very fine job) of February 2015 while I have one here that says (but the same one if I am not mistaken):

Now which is what and where is the one that gives me the latest information?
Rest assured, everything works fine now (as it did before) but I am just wanting to point out the difficulties for a newbie to get up to date as I am forced to start believing I am a newbie as well (which I am probably am compared to many others on this site):eek:.
Once again sorry, Jon, to test your patience:rolleyes:.

...to get the currently available version of a "ADE full manual" (aka "ADE User Guide"), one must manually download it via the link in this post:

http://www.fsdeveloper.com/forum/threads/ade-version-1-65-english-manual-released.433288/

Hi Roby:

If you click the link above, that post has a MediaFire download link for 'The new manual'

The new manual can be downloaded from the ADE web site downloads page or directly from here: http://www.mediafire.com/download/8rp6jr7en9xwdls


NOTE: "manual_english_165.zip" contains:

English Manual v1.65.pdf ...dated Feb 21, 2015

upload_2016-7-9_13-18-51.png


This indeed, is the "Fine Manual" that Jon referred to above; for "newbies" and "die-hards" it is a 'must-have' and 'must-read'. :teacher:


Hope this helps ! :cool:

GaryGB
 
Last edited:
Had that and read that a year ago (and more than once) but that did not help me much this time, did it:)?
It is not about the manual, Gary (that one is outstanding), it is all about the way how and where from people have to install the new version and how to use the extra features in the newest one.As I said before, we are biased because we have been following up on things (and still got confused:() but what about all those others? That is what I am trying to convince you of!
 
Generally if it goes wrong people ask ;)
 
Well, Jon,

With this new pinned thread of yours, it should be clear to everyone and would save you from people asking a lot of questions;).
Thank you in the name of all us jerks out there:).
Now have a lazy sunday afternoon,

Cheers,

PS (so that you know it is me): Are you planning on advertizing it also on some other websites (like Flightsim and Avsim?)
 
Thanks Roby

No at the moment I am not planning to advertize it on other sites. I might do that after a week or two when I have feedback from 'joe public' users :)
 
Since this type of product is primarily used by FS developers (whether freeware or payware), AFAIK, most of whom who work on projects in their limited 'spare time', they are more likely to need / want to take a copy of 'certain' files from FS and an installation of ex: ADE with them when traveling on a portable computer.

I personally would greatly appreciate having an option to download all necessary documentation for ADE in a portable form as a discrete file (or file 'set') ...that I can use offline,


I am often traveling in locations not accessible to (free) WiFi, and would not want to be forced to utilize limited (and otherwise costly) mobile phone bandwidth to tether a internet data connection to a portable computer in order to repeatedly access an "online-only" documentation system ...when in locations that even have a mobile phone tower, and one that also will:

* Allow full service (including 'data') roaming by my mobile phone without re-starting the device on the local tower

* Allow use of local towers during certain hours of the day by roaming customers of a 'competing' mobile phone provider


Regardless of how / when / where a FS developer one might be compelled to access the internet, I believe it would be beneficial to accessibility, usefulness, and ultimately the 'popularity' with end users of a product such as ADE, to have the option to download- or otherwise create- and link to via the Help pull-down menu etc. ...a 'offline' version of the documentation, as well as an option to browse the most current a "up-to-date" version "on-line".



Forum participants have made valid points that tracking all necessary info regarding 3rd party FS development utilities even within a well-organized and dedicated forum system such as utilized by ADE at FSDeveloper can be challenging enough, and having to then go out of that '1-stop-shop' environment to multiple other location(s) on the internet to stay current and get additional info on new features / procedures for a FS development utility ...may add to the "complexity" and detract from "ease-of-use" for a products intended end users.


The same situation is true of other FS utilities such as Arno's ModelConverterX and other excellent utilities; one may be fortunate to at least have access to some documentation (however limited in detail) for "release" (or "production") versions that does not reflect new features / procedures of newer "development" (or Beta / "Release Candidate") versions.

Although certainly Arno makes a diligent effort to document his "work-in-progress" for ModelConverterX and other utilities via his http://www.scenerydesign.org/ Blog, the FS Developer forums, and various YouTube channel videos (which seem to come and go over time), one must "search" those locations via ex: Google to find fragments of information which might serve as "documentation" for new features / procedures of newer "development" (or Beta / "Release Candidate") versions.



No doubt it is also at least as challenging (...if not more-so ! ) for the programmers that develop FS utilities to provide up-to-date documentation for their programs, as it is for end-users to find / access such documentation (please note that these comments are not intended to criticize the generous efforts of developers of 3rd party FS development utilities). :oops:


I would merely wish to point out here, the 'mutual' benefit to both developers of FS utilities and their end-users ...to have current documentation available for "release" (or "production") program versions in both online and offline formats.


Given the challenges programmers also face with developing FS utilities in their limited 'spare time', even though it is more of a 'standard' in the "in the real world" of commercial software industry to have documentation for all current features in a form which accompanies each "release" (or "production") program version in a offline format, some also offer such documentation online as an option.

Alternatively, in 'rare' cases with commercial software "in the real world", documentation is instead accessed exclusively online, and only brief Read-Me's and Installation guides are included; but in my experience thus far, this is primarily done with "Beta / Release Candidate" software, rather than with "release"- or "production"- program versions.



When is not feasible (or desirable) for developers of FS utilities to provide offline documentation, IMHO, it would otherwise be mutually beneficial that such on-line documentation be made accessible via a web page format and server environment that is compatible with multiple versions of popular web browsers that may be used to save complete web pages to the end users local storage device. :idea:

IMHO, it would also be preferable that such on-line documentation be made accessible via a server environment that is compatible with sophisticated utilities that capture multiple levels of online web-linked documentation onto end users' own local storage device with locally-linked URLs for subsequent ongoing "portable" use. ;)


And of course, we must acknowledge that even with documentation that was provided with the RTM / downloaded patches or updates to MSFS and its SDK, most FS developers are still compelled to search for additional information critical to anything more than basic usability, throughout multiple FS web sites.


Some of those web sites do not allow search engine robots to index and 'direct-link' to web pages on their web sites, and instead insist on creating unique session ID strings in web page URLs (...often longer than this post ! :p ) to keep statistics on web site visitors AFAIK for purposes presumably legal and useful to themselves, but IIUC, not necessarily useful to end users trying to use a search engine providing links while trying to:

* learn about their products

* make a decision for- or against purchase / licensure

* make full use of the the latest release of their product after purchase / licensure.


Again, these comments are not intended to criticize, but instead, to post some observations of the mutual concerns affecting FS utility developers and their end users, and to offer suggestions which might prove mutually beneficial to all parties, with a well-intended reminder that all such endeavors as involve MSFS take place in the context of a highly-specialized "niche-within-a-niche" inside the much larger "real" world of commercial software.


I hope this may help make FS utility software, and FS add-ons "...As Real As It Gets" in the future :)

GaryGB
 
Last edited:
Sorry Gary but the on-line documentation is just that and I do not have the time or the facilities to duplicate it off line.
 
Thanks for the reply, Jon. :)

I guess we'll just have to try and see how the documentation server(s) can deal with a web browser capable of saving complete pages and/or a web site caching utility ...to allow end users the option of create their own offline documentation for ADE. :scratchch

GaryGB
 
Well you can certainly do that. However one of the benefits of on-line documentation is that it is more flexible and easier to keep up to date. I can create, change or delete articles in a few minutes. And it is, by the way, hosted on one of the major documentation services - which costs a not insignificant amount
 
Many thanks for your efforts to provide timely web access to current / updated documentation for ADE, Jon. :)

Hopefully I can use software that will allow keeping a local "offline" copy for my own review (when traveling with a portable computer) that properly accesses the required web data ...while also "playing nice" with any web servers that host such info. :coffee:

[EDITED]

PS: I just browsed the documentation site linked in this thread:

http://www.fsdeveloper.com/forum/threads/ade-1-70-production-version.437726/


Looks good, and thanks as well for a local site search feature that actually accepts 3-character query strings ! :D


FYI
: Google already has indexed that site, and can direct link ! :wizard:

[END_EDIT]

GaryGB
 
Last edited:
Let us try to give a resumé here of this thread, call an end to it and say:
Great, Jon, this is what we wanted. Thanks a bunch.
I am not an administrator so I cannot put an end to this thread:), but I would if I could.
Going to prepare my macaroni now:D.
Cheers
 
FYI:

* While searching the FS Developer web site on Google, one may include specific registered user posts via this example query string:

site:www.fsdeveloper.com GaryGB ADE documentation



While searching the FS Developer web site on Google, one may exclude specific registered user posts via this example query string:

site:www.fsdeveloper.com -GaryGB ADE documentation


NOTE: One must utilize the exact forum Avatar name spelling as it appears in FS Developer forum posts. :pushpin:

* One can substitute the name of any other specific registered users at the FS Developer web site in Google Search queries. ;)


Hope this helps ! :)

GaryGB
 
Back
Top