Java Documentation Suggestions

Discussion in 'Client & Site Suggestions' started by Arbiter, Mar 9, 2014.

  1. Arbiter

    Arbiter Mod Automation

    Joined:
    Jul 26, 2013
    Messages:
    2,556
    Likes Received:
    1,079
    In order to make the Java Documentation as comprehensive as possible for our developers, we are asking for suggestions of specific classes/methods to expand upon. Just provide a brief description below and we will address it promptly.

    Thanks.
     
  2. Arbiter

    Arbiter Mod Automation

    Joined:
    Jul 26, 2013
    Messages:
    2,556
    Likes Received:
    1,079
    @Cloud Execution class needs specification as to which unit of time is used for delays (milliseconds) as requested by @Salvation.
     
  3. Trigoon

    Joined:
    Oct 14, 2014
    Messages:
    8
    Likes Received:
    3
    The whole API should be documented thoroughly, I have not yet seen a botting client with a flush and complete API with rich documentation.
     
  4. Cloud

    Joined:
    Jul 28, 2013
    Messages:
    2,554
    Likes Received:
    922
    Although I agree, it takes a considerable amount of time to do detailed and proper documentation. I do try to add more documentation periodically however I'm aware there are sections that are still lacking. If there's ever a point that you find problematic, please comment and I'll gladly write some up.
     
  5. Calle

    Joined:
    Nov 23, 2013
    Messages:
    48
    Likes Received:
    10
    asign bot authors to do it, especially the ones that are very familiar with the api
     
  6. Cloud

    Joined:
    Jul 28, 2013
    Messages:
    2,554
    Likes Received:
    922
    That can't really be done in any productive way because the javadocs have to be packaged with the source code.
     
  7. Calle

    Joined:
    Nov 23, 2013
    Messages:
    48
    Likes Received:
    10
    damn :/
     
  8. Cloud

    Joined:
    Jul 28, 2013
    Messages:
    2,554
    Likes Received:
    922
    Feel free to point out specific sections that you feel are under documented. Anything that's self explanatory will be gradually filled out but right now I'm most worried about things that aren't clear enough.
     
  9. Defeat3d

    Defeat3d Prime Celestial

    Joined:
    Oct 30, 2014
    Messages:
    1,392
    Likes Received:
    597
    Docs need an update I think, World class doesn't exist anymore. Took me a while to find out.
     
  10. Cloud

    Joined:
    Jul 28, 2013
    Messages:
    2,554
    Likes Received:
    922
    Updated.
     
  11. SuperBotter

    SuperBotter Super Bot Author

    Joined:
    Jun 24, 2016
    Messages:
    129
    Likes Received:
    48
    ClientUI.showAlert() could be described. It's the green notification bar on the top of the RuneMate window, right?
     
  12. Snufalufugus

    Joined:
    Aug 23, 2015
    Messages:
    1,053
    Likes Received:
    456
    Almost the entirety of
    • com.runemate.game.api.hybrid.player_sense.PlayerSense.Key
    It has literally no information for most keys besides their names.
    --- Double Post Merged, Apr 20, 2017, Original Post Date: Mar 30, 2017 ---
    Inside of "Magic" there is:
    activate
    public boolean activate()

    For most spells this is enough, but it's not clear to authors that they can put the action into activate() to specify what to cast in the case of multiple spells being on the same icon.
     
    Jux7apose likes this.

Share This Page

Loading...