Gamelogic
  • Home
  • Blog
  • Tools
    • Grids 2 (for Unity)
      • Features
      • Documentation
    • Grids 1 (Legacy, for Unity)
      • 30 games in 30 days
      • Features
      • Tutorials, Documentation, and FAQ
      • Games made with Grids for Unity
      • Examples
      • What is new?
      • Grid Prototypes and Previews
      • Buy
    • Extensions
    • Colors
      • Features
      • Documentation and tutorials
      • Buy
    • Words
      • Features
      • Documentation
      • Buy
    • Abstract Strategy
      • Features
      • Documentation and tutorials
      • Examples
      • Buy
    • Match
      • Features
    • Grids (for GameMaker)
      • 30 games in 30 days
      • Features
      • Documentation
      • Buy
  • Buy
  • Articles
  • Support
    • Knowledge Base
    • Email Support
  • About
    • Meet our team

Blog

Tool Documentation Overhaul

We started this week to do a major overhaul to the documentation of our tools.

The first step was to use a different HTML generator.

We used GhostDoc before, but we have had some big problems with the generated HTML. Many links were broken because GhostDoc generate links with the wrong case (we reported this to them but so far, no luck with a fix). Although we could fix this by hacking the HTML ourselves, it also meant the documentation was not searchable, which makes it much less useful.

We use Sandcastle now, and so far, it seems to be working great. Sandcastle also allows us to add some conceptual documentation, which means we can bring together the documentation spread all over the site to one place. You can already see the extra pages we added for Grids 2: http://gamelogic.co.za/documentation/grids2/.

The second step is to “translate” the many documentation articles we made for Grids 1 to Grids 2. One example of this is the guide we wrote that shows how to do everything in Amit Patel’s great Hexagonal Grids article with the Grids library. You can see the work-in-progress result here: http://gamelogic.co.za/documentation/grids2/html/f9d4f8f2-6eaa-4e52-bb24-0bca2a06a541.htm.

The third step (and this is really happening concurrently with step 2) is to add the many missing API documentation entries, starting with the most important classes (such as GridPoint2 and IGrid) and working our way down to the more obscure machinery such as IPointPartition.

And after this, we have to do the same for the other tools!

It will be a long process, and we want to upload the newest version of the documentation every day or two, so it means you may see the odd ghost of a GhostDoc tag that is misinterpreted, or pages that are incomplete. Please be patient 🙂 And if you see anything amiss, please let us know, and if you have questions, ask us on the Knowledge Base.

Share this:

  • Click to share on Facebook (Opens in new window)
  • Click to share on Twitter (Opens in new window)
  • Click to share on LinkedIn (Opens in new window)
  • Click to share on Reddit (Opens in new window)
  • Click to share on Pinterest (Opens in new window)

Related

  1. Gamelogic Extensions for Unity 1.2 is now available  The newest version of our free extensions library is now...
  2. The birth of Game Dev Santiago  4th March 2015 Make Games SA is the official game...
  3. What is new in Grids Pro 2.3.2  Our dear Grids Pro has been updated too. We are...
  • Permalink
  • Posted: 23 June 2017
  • Tags: documentation, tools
  • Comments: 1
  • Author: Gamelogic

Comments (1)

  1. Boz

    8 February 2018 at 19:06

    How’s this going?

Comments are closed.

Recent Posts
  • Tool Documentation Overhaul
  • What is new in Grids Pro 2.3.5
  • What is new in Grids Pro 2.3.2
  • What is new in Abstract Strategy 2.1.1
  • What is new in Words 2.0.2
Categories
  • 30 Games in 30 Days
  • AbstractStrategy
  • Aside
  • Colors
  • Example
  • Extensions
  • General
  • Grids
  • Grids 2
  • Previews
  • Programming
  • Social Media
  • Uncategorized
  • Words
Follow us on Twitter
My Tweets
Meta
  • Log in
  • Entries RSS
  • Comments RSS
  • WordPress.org
  • Home
  • Features
  • Blog
  • About
  • 14 Eglin Road, Sunninghill, Johannesburg, South Africa
  • support@gamelogic.co.za
Stay Connected
  • Facebook
  • Google
  • Linkedin
  • Rss
  • Twitter
  • Gamelogic © 2013