Gemini Community Support Site

This Gemini community support site can be used to find solutions to product issues. You can log in using Open Id, Google Profile and even Facebook. Feel free to ask a question or browse FAQs and documentation. Product tour videos are also available along with how-to videos demonstrating key Gemini capabilities.




Documentation?

api

Is there any documentation out there for the web service other than the .NET sample code? I'm not a .NET programmer, and those projects have enough complexity to them, and MS has enough dependency on their toolset, that the samples are basically just worthless to me. Heck, I don't even use Windows, so even the terminology sometimes throws me for a loop. The app docs have nothing on the web service other than to basically say it exists and the very brief mention of the access code.

By digging around the forum here, I did at least figure out the URL to the WSDL and to the SOAP server. The WSDL helps in the docs department, but really, a WSDL doesn't go very far in that department, plus it isn't exactly reader-friendly. What I'd really like to see is a standalone web page or PDF file that has the following:

  • An overview of the web service... how to access it, how security is handled, a high-level explanation of how to use it, and a high-level view of what you can accomplish with it.

  • An explanation of the data types and common parameters used in the API.

  • A list of all methods, broken down by category. Include with each an explanation of what it does, what the parameters are that it takes, and what it returns.

The current state of affairs exemplifies a problem with Gemini: it's written assuming a very Microsoft-centric world view. The app may be written in .NET, but it's quite likely that the majority of your users are not .NET programmers and many (like me) may not even be Windows users. Yet, everything in the Gemini ecosystem is MS-centric. For example, I'd love to have an SVN hook that didn't rely on a Windows DLL, since my repositories are not hosted on Windows servers (as I bet is the case for many users). Thus, I get to do it myself. And the web service - that should be very platform-agnostic, but example code is only in .NET, which is perhaps the worst choice for non-.NET programmers because the simple example requires so much baggage around it. I guess there's some form of docs provided by VS when you open the project, but that doesn't help me. And though I don't know for sure since I can't make heads from tails of the code, I suspect it only demonstrates the WSE-compliant (?) access method, which, again, means it's just MS developers. At the very least, an example in PHP or Python would probably help a lot of *nix folks.

Anyway, if there are some great docs and non-.NET samples out there that I've missed, ignore all this and point the way. Otherwise, I'd love to see some created.

bobw
· 1
bobw
Replies (5)
helpful
0
not helpful

I Agree 100% with your comments. Unfortunately, we do not have such samples.

However, we are redeveloping the Gemini web services for the 3.5 release. This will include REST web services and documentation. So you should be able to use it with any software!

Feel free to leave more feedback.


Mark Wing
· 9108
Mark Wing
helpful
0
not helpful

Okay, we've got 3.5 installed now. Maybe I'm just dense, but... where's the documentation for the new web services? All I've been able to find are the docs that tell you how to configure the server to support REST services, but those are of no help to me.

Thanks.


bobw
· 1
bobw
helpful
0
not helpful

We are still working on the REST docs as we speak. We expect to release them next week.


Saar Cohen
· 5000
Saar Cohen
helpful
0
not helpful

Any updates on the docs?

Thanks!


bobw
· 1
bobw
helpful
0
not helpful

We are hoping to have this ready with the 3.5.1 release (by Monday).


Saar Cohen
· 5000
Saar Cohen