Request for White Papers, QuickStart Guides, Samples

[Hakan_Celik]

Hello,

There are a lot of high quality support information on ThinkGeo Web site. But, they are scattered over forum messages, FAQs, samples etc. 

As a result, sometimes it is quite hard to reach the information, although it is there. If you look at forum topics, you could see that a lot of things are asked and answered over and over again (for example the shape file index for performance). This makes it hard to access information for us and also increases the load on the support personnel unnecessarily. 

Forums and FAQs are OK for their purpose but, in my opinion, we need more documents consisting of consolidated information.

May I suggest that the related information be consolidated into following items ? Also, if one or more of them exist already, can you point me to them ? 

Of course, these are needed from my point of view. So, I invite everyone to add their requests to this list, so that ThinkGeo will know what the customers / prospective customers need. If there are enough requests, I'm pretty sure they would make the effort to create them.

Hakan Çelik

List of Suggestions

1) QuickStart Guides : They are very good and helpful. More would be better. Even better would be 2 or 3 levels of guides concentrating on different subjects, such as : QuickStart - Introduction, QuickStart - Intermediate and QuickStart - Advanced.

2) White Paper : Introduction to Map Suite : This would outline the class hierarchy, relationships between them, higher and lower level classes, basic concepts (layers, zoom levels, renderers etc.), workload sharing between the server and client side (ie what is done on the Web server and what is done on the Web browser). This way a newcomer could easily see how the system works, what is available and how they might be used. I hhink of this as a sort of system definition document not a source code sample collection, there are other documents and also samples for that purpose.

3) White Paper : Best Practices for Performance : What are the best practices to get the maximum performance ? How to structure the shape files, how to do the layering, how to arrange zoom levels, how to use caches etc.

4) White Paper : Best Practices for Load Balanced Configurations : We can not rely on only one physical server to run our business on. So, it is a necessity to go to a load balanced configuration. Are there any pitfalls in such enviroments regarding the Map Suite ? What (if any) needs to be done / taken into consideration ?

5) Sample : Markers :  We can not do without them, so let's make the best use of them. Full marker capability demonstration. Setting, dragging, rendering, projecting, joining with lines then converting to a ploygon etc. The more the better :)

 

[David]

Hakan, 
  
   I completely agree with you.  We need to consolidate our information and get some solid docs out there.  The big hurdle up until now has been our products being in Beta and documents become old very quickly when the API is changing. 
  
   Over the next three months there will be a massive effort to put together our user manual. Now that many of our 3.0 platform products are out of beta we will be on solid ground to write it. We plan to make this a comprehensive document with topics from introduction to GIS concepts to advanced performance tuning and everything in-between.  The format we are taking is working on white papers that will be compiled into the manual.  We are trying to write them somewhat self contained but make sense together.  This way we can distribute them as we write it and you don’t need to wait until it is all done.  You will see a steady stream of documents coming out of here soon. 
  
   Another thing we are looking to do is add a search to our HowDoI samples so it will be easier to match keywords you are interested in to the samples.  We are also looking into a knowledge base hosted in the forums that are based on user posts but cleaned up.  This is something you might want to gloss over to see if anything catches your eye.  I think the titles are key for finding what you need. 
  
 If there are specific topics you are interested in please email us at support@thinkgeo.com and ask it be forwarded to Ben. 
  
 Keep your suggestions coming! 
  
 David

[Hakan_Celik]

David, 
  
 Thank you very much. I’m awaiting the docs eagerly. 
  
 I’m trying to put my questions in order and when I’m finished, I will direct them to Ben as you suggested. 
  
 Hakan

[dominiauk]

Hi, 
  
 We certainly do need more guides / information - however waiting 3 months is too long a lot of companies (especially mine) have a few days at the start of a new version to review it and determine if we should upgrade / switch to it. So the more information at the start the better. Unfortunetly in 3 months the decision is made and that’s the end of it for us.  
 In the past most of the documentation has been aimed at really simple use of your engine and it’s difficult as Hakan says to get any more advanced help on the none basic functionality. This is especially the case of the services editions which seem to always get less support / information than the web edition - and of course is normally the most complicated. 
  
 How a about a pinned forum article which contains all the knowledge info from other forum posts combined into one article (cut and pasted in) so that we have one location to review until the guides are done in 3 months time? 
  
 Andy

[David]

Andy, 
  
   Our plan is to have everything complete in three month.  Like you mentioned the approach will be to write up each topic as a white paper and release them as we get them complete.  This way there will be a steady stream of information coming to you guys.  We have a white papers forum, it is currently empty, but this is where they will go.  The whole 3.x product line is just getting rolled out and we have everyone focused on finishing up all the details such as the white papers.  We also want to make sure that the papers are written by the developers who designed the technology, before the releases these guys were in short supply.  We want our papers to be spot on and really nice to read. 
  
   We realize that you, our customers or potential customers, need help now and not after three months.  To this end we have crack staff to answer discussion forum posts and have a fast turn around time.  I think you will see in the forum that we do everything we can to help people use our product during this period while the documentation still isn’t finished.  We are also very approachable as well on the phone.  If you have an architecture in mind give us a call and we can setup a technical discussion.  You will get to talk with one of our knowledgeable techs that can help you work out the high level stuff and even get down and dirty if necessary.  Please use every support channel we have to help yourself make the right decisions up front. 
  
   If there are specific topics you want us to address first please let us know.  We would be happy to schedule papers that you guys need first. 
  
   Talking about sticky topics we have discussed this internally here for some time.  It seems some people get turned off when there is a ton of sticky messages in a forum.  They have to go to the Nth page to get to a real recent post.  Because of this we don’t do this now.  What we plan to do is to create more of a FAQ type forum where really good forum questions get cleaned up and re-labeled.  These can be locked and moved into this other forum.  The problem now is that we have many directions in regards to help and we don’t have enough resources to do them all at the same time. 
  
   I do appreciate all of your comments and suggest, good or bad, keep them coming. 
  
 David