Using Confluence 'spaces' for documentation

[Cheetham, Anastasia]

On 2010-09-10, at 2:39 PM, Wong, Harris wrote:

> Hello Anastasia,
> 
> Not sure if you have checked Drupal API: http://api.drupal.org/api/5
> 
> They have a nice way of handling different versions of documentation.  Hope it helps.
> 
> -harris

Thanks for the pointer, Harris. I like this - very clear. The URLs reveal an interesting point about how they version the individual pages: The version number is the *last* element of the path, so

http://api.drupal.org/api/constant/MENU_DYNAMIC_ITEM/4.7
http://api.drupal.org/api/constant/MENU_DYNAMIC_ITEM/5

And each of these lower-level pages has a tab for the different versions, which conveys what versions this particular function is available in. Interesting...

And I'd assume that this site is implemented in Drupal, which we do have some experience in :-) Heidi and Jon, any thoughts on the idea of using Drupal for our API documentation?

-- 
Anastasia Cheetham     Inclusive Design Research Centre
acheetham at ocad.ca            Inclusive Design Institute
                                        OCAD University