User talk:Red Leader: Difference between revisions

Referring to the commit/change at [http://wiki.flightgear.org/index.php?title=Nasal_library&oldid=89398]. I appreciate what you are doing there, but I would really suggest not to spread our Nasal API docs across multiple articles. The NavCache article documents an underlying implementation detail of the NavDB, i.e. it being cached using a very fragile SQLite layer, so it is mainly about the "cache", but not the functionality provided on top of it, i.e. the NavDB itself. And in fact, at some point, we were not even using/having such a caching layer, and we may not even have the cache in its current form in the future given how this has crippled the FG experienced for literally hundreds of FG users. So I would suggest not to split up our docs by adding useful info to related articles. For instance, at some point we had another attempt at "caching" using the metakit dependency - which is meanwhile gone. Which is to say that the cache is an implementation detail, that may be subject to change sooner or later (hopefully just subject to fixing), but the public/external APIs are unlikely to change in any major way, because end-users rely on those. And one of the most significant feats you have pulled off with your Nasal docs article is consolidating all the info in a single place, which makes it much easier to update things in the future, especially should things change at some point, especially because of all the templates you are using. So I really vote for having a single monolithic article for the time being, i.e. it may be better to either refer to the reference section you created, or include it using a template instead - to ensure that we don't violate the DRY-principle but still have everything neatly encapsulated (imagine fixing up the API template to link back to tons of unrelated articles).--[[User:Hooray|Hooray]] ([[User talk:Hooray|talk]]) 10:49, 10 November 2015 (EST)