esi-docs icon indicating copy to clipboard operation
esi-docs copied to clipboard

eve-glue and esi.evetech.net

Open GoldenGnu opened this issue 6 years ago • 2 comments

  • [ ] Add link to https://github.com/esi/eve-glue (maybe to #using-esi-data?)
  • [ ] Add link to https://esi.evetech.net/ in the readme (There is already a link in esi_introduction.md maybe that is enough?)

I would do it myself, but, it end up being CarbonAlabel who did all the work the last time...

GoldenGnu avatar Mar 19 '19 22:03 GoldenGnu

Some thoughts on this:

As mentioned in https://github.com/esi/eve-glue#readme, it would be best if apps used the string values returned by ESI enums, and not the IDs and bitmasks that are used to represent them in the monolith, so if anything, I'd link to it from the "Transitioning from XML/CREST" docs.

The front page of the docs could indeed use a nice, big link to https://esi.evetech.net/. As for https://docs.esi.evetech.net/docs/esi_introduction.html, it could use an overhaul to make it read less like marketing talk (which, being a copy-paste of https://developers.eveonline.com/blog/article/introducing-the-esi-api, it actually is), and more like a guide on taking your first steps with ESI.

CarbonAlabel avatar Apr 14 '19 20:04 CarbonAlabel

ESI enums is the right way to store those values, but, to get the text used in-game, you still need to do enum -> id -> sde. Therefore, It is my opinion is that glue is still an important part of ESI development and should be part of the documentation (until an alternative to get the in-game text is available). That is just my opinion, though, and I may be totally wrong...

GoldenGnu avatar Apr 15 '19 17:04 GoldenGnu