Ex-Staff
Lone Wolf Staff
Join Date: Jul 2013
Posts: 961
|
Yeah. We're also frustrated that we don't have as much time as we'd like to update our documentation. As TheIronGolem alluded to, good documentation takes time. Given our small team, we have a lot of things competing for our time. Sometime things have to be put on hold. Unfortunately, updating our documentation has been one of those things.
|
#21 |
Junior Member
|
Quote:
|
|
#22 |
Junior Member
|
This ... seriously made me laugh and give up a bit of my own grief in doing so ... YOU UNDERSTAND!!!! YOU KNOW!!!
FINALLY!!!!! Quote:
And yes i have looked at all of that stuff sigh words cannot express how i relate to you right now. they just can't. THANK YOU for saying what you did! |
|
#23 |
Senior Member
Join Date: Sep 2015
Posts: 435
|
I'm one of the lead developers on RPTools (or used to be; I haven't written a lick of code in a long time ) and we have a problem with documentation on all of our tools and our scripting language for MapTool, MTscript.
It is difficult for the development team to keep the docs up to date as most users want the developers to be, you know... "developing". One of our team members put up a wiki that the users now keep up to date. It isn't perfect, but it lets the users share their knowledge -- and their experience -- with other users. I'm just learning the scripting language that HL uses. I see it has some of the same issues that MTscript has: a wimpy editor (no "intellisense" or syntax highlighting); the editor UI is cluttered; the tooltips are not particularly helpful; and as Prophet says, there doesn't seem to be any kind of aggregation of globals lists (I posted on this in another thread this morning and then subscribed to this forum, just so I'd get to see the answer if/when it's posted!). One thing that would go a long way in HL scripting is for the compiling process of HL data files to spew out a list of all tags for all components into a log file. Maybe this would only be turned on when "Show Debug Output" is turned on, so that 99% of users wouldn't see that disk space taken up, but it would sure be handy for developers! Granted, there could be runtime tags added, but if you're developing new code you know what your own tags are -- it's the ones you don't know that are the bottleneck, and most of them are going to be static. In our own project, RPTools is transitioning to the latest version of Java and JavaFX and they include a lot of new features that we expect will magically fix some of our problems (we're switching to JavaScript and dumping our custom and proprietary language, for example, and a lot of IDEs support JavaScript), but it's a long journey and we're just volunteers working on a labor of love. HL can't easily do this anyway as it's not as simple for them as just upgrading the runtime environment. Anyway, I want to say to Prophet, "I feel your pain." And to the HL developers and support staff here, I would say, "I know your pain." |
#24 |
|
|